Docs 菜单
Docs 主页
/
MongoDB Manual
/ / / /

$pullAll

在此页面上

  • 定义
  • 行为
  • 示例
$pullAll

$pullAll 操作符会删除现有数组中所有指定值的实例。与 $pull 操作符通过指定查询来删除元素不同, $pullAll 会删除与列出值相匹配的元素。

$pullAll 操作符具有如下形式:

{ $pullAll: { <field1>: [ <value1>, <value2> ... ], ... } }

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

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

如果要移除的 <value> 是文档或数组,$pullAll 只会移除数组中与指定 <value> 完全匹配的元素,包括顺序。

从 MongoDB 5.0 开始,使用带空操作数表达式 ({ }) 的更新操作符(如 $pullAll)时,mongod 不会再引发错误。空更新不会导致任何变化,也不会创建 oplog 条目(意味着该操作为“无操作”)。

创建 survey 集合:

db.survey.insertOne( { _id: 1, scores: [ 0, 2, 5, 5, 1, 0 ] } )

以下操作将从 scores 数组中删除值 "0" 和 "5" 的所有实例:

db.survey.updateOne( { _id: 1 }, { $pullAll: { scores: [ 0, 5 ] } } )

更新后,scores 字段不再包含任何“0”或“5”的实例。

{ "_id" : 1, "scores" : [ 2, 1 ] }

提示

另请参阅:

后退

$push

在此页面上