$unset

定义

$unset

$unset操作符删除特定字段。

兼容性

可以使用 $unset 查找托管在以下环境中的部署：

• MongoDB Atlas ：用于在云中部署 MongoDB 的完全托管服务

• MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

• MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

考虑以下语法：

{ $unset: { <field1>: "", ... } }

$unset表达式中的指定值（即"" ）不会影响操作。

要在嵌入式文档或数组中指定 <field>，请使用点符号。

行为

从 MongoDB 5.0 开始，更新操作符按字典顺序处理具有基于字符串的名称的文档字段。具有数字名称的字段按数字顺序处理。详情请参阅更新操作符行为。

如果该字段不存在，则$unset不执行任何操作（即不进行操作）。

与$一起使用以匹配数组元素时， $unset会将匹配元素替换为null ，而不是从数组中删除匹配元素。此行为使数组大小和元素位置保持一致。

从 MongoDB5 0mongod$unset{ }开始。当您将 等更新操作符与空操作数表达式 ( ) 一起使用时， 、 不再引发错误。空更新不会导致任何更改，也不会创建 oplog 条目（意味着该操作为“不操作”）。

例子

创建 products 集合：

db.products.insertMany( [
   { "item": "chisel", "sku": "C001", "quantity": 4, "instock": true },
   { "item": "hammer", "sku": "unknown", "quantity": 3, "instock": true },
   { "item": "nails", "sku": "unknown", "quantity": 100, "instock": true }
] )

更新 products 集合中的第一个 文档，其中 sku 的值为 unknown：

db.products.updateOne(
   { sku: "unknown" },
   { $unset: { quantity: "", instock: "" } }
)

updateOne()使用$unset操作符执行以下操作：

• 删除 quantity 字段

• 删除 instock 字段

{
  item: 'chisel',
  sku: 'C001',
  quantity: 4,
  instock: true
},
{
  item: 'hammer',
  sku: 'unknown'
},
{
  item: 'nails',
  sku: 'unknown',
  quantity: 100,
  instock: true
}