$unset

定义

$unset

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

兼容性

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

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

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

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

语法

考虑以下语法：

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

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

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

行为

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

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

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

从 MongoDB 5.0 开始，使用带空操作数表达式 ({ }) 的更新操作符（如 $unset）时，mongod 不会再引发错误。空更新不会导致任何变化，也不会创建 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
}