$pullAll（更新操作符）

定义

$pullAll

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

$pullAll操作符的形式为：

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

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

行为

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

如果要删除的<value> 是文档或大量，则$pullAll 仅删除大量中与指定的<value> 完全匹配的元素，包括顺序。

从MongoDB5.0 开始，当您将 等更新操作符符与空操作数表达式()mongod $pullAll一起使用时，{ } 不再引发错误。空更新不会导致任何更改，也不会创建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 ] }