$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 }