$unset

本页内容

定义

兼容性
语法
行为
示例

定义

注意

区分

以下页面涉及更新运算符$unset。关于聚合阶段，请参阅$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开始，mongod不再在您使用类似$unset的更新运算符与空操作数表达式（{}）时引发错误。空更新不会导致任何更改，也不会创建操作日志条目（这意味着该操作是无操作）。

示例

创建 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
}

提示

另请参阅

db.collection.updateMany() db.collection.findAndModify()

$setOnInsert

数组