《MongoDB入门教程》第18篇 文档更新之$unset操作符

Posted 2023-01-13 不剪发的Tony老师

本篇将会介绍如何利用 $unset 操作符删除文档中的字段。

$unset 操作符

$unset 是一个字段更新操作符，用于删除文档中的指定字段。

$unset 操作符的语法如下：

 $unset: <field>: "", ... 

参数中的字段值不影响操作结果，可以指定任意值。如果指定字段不存在，不会执行任何操作，也不会返回错误或者警告。

如果想要指定嵌入书文档中的字段，可以使用点符号：

 $unset:  "<embedded_doc>.<field>": "", ... 

需要注意的是，$unset 操作符不会删除任何数组元素，而是将数组元素设置为空。

 $unset: "<array>.<index>": "", ...

这种实现可以保持数组大小和元素位置的一致性。

$unset 示例

下文中的示例将会使用 products 集合：

db.products.insertMany([
     "_id" : 1, "name" : "xPhone", "price" : 799, "releaseDate": ISODate("2011-05-14"), "spec" :  "ram" : 4, "screen" : 6.5, "cpu" : 2.66 ,"color":["white","black"],"storage":[64,128,256],
     "_id" : 2, "name" : "xTablet", "price" : 899, "releaseDate": ISODate("2011-09-01") , "spec" :  "ram" : 16, "screen" : 9.5, "cpu" : 3.66 ,"color":["white","black","purple"],"storage":[128,256,512],
     "_id" : 3, "name" : "SmartTablet", "price" : 899, "releaseDate": ISODate("2015-01-14"), "spec" :  "ram" : 12, "screen" : 9.7, "cpu" : 3.66 ,"color":["blue"],"storage":[16,64,128],
     "_id" : 4, "name" : "SmartPad", "price" : 699, "releaseDate": ISODate("2020-05-14"),"spec" :  "ram" : 8, "screen" : 9.7, "cpu" : 1.66 ,"color":["white","orange","gold","gray"],"storage":[128,256,1024],
     "_id" : 5, "name" : "SmartPhone", "price" : 599,"releaseDate": ISODate("2022-09-14"), "spec" :  "ram" : 4, "screen" : 5.7, "cpu" : 1.66 ,"color":["white","orange","gold","gray"],"storage":[128,256]
 ])

示例一：删除文档中的字段

以下示例使用 $unset 操作符删除文档（_id:1）中的 price 字段：

db.products.updateOne(
    _id: 1
, 
    $unset: 
        price: ""
    
)

返回结果如下：

  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0

其中，modifiedCount 表示修改了一个文档。

查询集合 products 中的全部文档：

db.products.find(,  name: 1, price: 1 )

[
   _id: 1, name: 'xPhone' ,
   _id: 2, name: 'xTablet', price: 899 ,
   _id: 3, name: 'SmartTablet', price: 899 ,
   _id: 4, name: 'SmartPad', price: 699 ,
   _id: 5, name: 'SmartPhone', price: 599 
]

从返回结果可以看出，文档（_id:1）中已经没有了 price 字段。

示例二：删除嵌入式文档中的字段

以下示例使用 $unset 操作符删除集合 products 中嵌入式文档 spec 中的 ram 字段：

db.products.updateMany(, 
    $unset: 
        "spec.ram": ""
    
)

返回结果如下：

  acknowledged: true,
  insertedId: null,
  matchedCount: 5,
  modifiedCount: 5,
  upsertedCount: 0

查询集合 products 中的全部文档：

db.products.find(, 
    spec: 1
)

[
   _id: 1, spec:  screen: 6.5, cpu: 2.66  ,
   _id: 2, spec:  screen: 9.5, cpu: 3.66  ,
   _id: 3, spec:  screen: 9.7, cpu: 3.66  ,
   _id: 4, spec:  screen: 9.7, cpu: 1.66  ,
   _id: 5, spec:  screen: 5.7, cpu: 1.66  
]

示例三：将数组元素设置为空

接下来的示例使用 $unset 操作符将数组 storage 中的第一个元素设置为 null：

 db.products.updateMany(,  $unset:  "storage.0": ""  )

返回结果如下：

  acknowledged: true,
  insertedId: null,
  matchedCount: 5,
  modifiedCount: 5,
  upsertedCount: 0

查看数组 storage 中的内容：

db.products.find(,  "storage":1)

[
   _id: 1, storage: [ null, 128, 256 ] ,
   _id: 2, storage: [ null, 256, 512 ] ,
   _id: 3, storage: [ null, 64, 128 ] ,
   _id: 4, storage: [ null, 256, 1024 ] ,
   _id: 5, storage: [ null, 256 ] 
]

示例四：删除多个字段

以下示例使用 $unset 操作符一次性删除了文档中的 releaseDate 和 spec 字段：

db.products.updateMany(, 
    $unset: 
        releaseDate: "",
        spec: ""
    
)

返回结果如下：

  acknowledged: true,
  insertedId: null,
  matchedCount: 5,
  modifiedCount: 5,
  upsertedCount: 0

验证更新后的文档内容：

db.products.find(, 
    name: 1,
    storage: 1,
    releaseDate: 1,
    spec: 1
)

[
   _id: 1, name: 'xPhone', storage: [ null, 128, 256 ] ,
   _id: 2, name: 'xTablet', storage: [ null, 256, 512 ] ,
   _id: 3, name: 'SmartTablet', storage: [ null, 64, 128 ] ,
   _id: 4, name: 'SmartPad', storage: [ null, 256, 1024 ] ,
   _id: 5, name: 'SmartPhone', storage: [ null, 256 ] 
]

查询返回的结果中没有 releaseDate 和 spec 字段。