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