Docs 菜单
Docs 主页
/
MongoDB Manual
/
参考
/
操作符
/
更新
/
字段

$unset

在此页面上

  • 定义
  • 兼容性
  • 语法
  • 行为
  • 例子

定义

注意

消歧

以下页面涉及更新操作符 $unset 。关于聚合阶段，请参阅 $unset 。

$unset

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

兼容性

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

  • MongoDB Atlas ：用于在云中部署 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
}

提示

另请参阅：

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

后退

$setOnInsert

来年

数组

在此页面上