db. 集合.updateMany()（mongosh方法）

参数

updateMany() 方法采用以下参数：

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

// INVALID
[
  { "x.a": { $gt: 85 } },
  { "x.b": { $gt: 80 } }
]

// Example 1
[
  { $or: [{"x.a": {$gt: 85}}, {"x.b": {$gt: 80}}] }
]
// Example 2
[
  { $and: [{"x.a": {$gt: 85}}, {"x.b": {$gt: 80}}] }
]
// Example 3
[
  { "x.a": { $gt: 85 }, "x.b": { $gt: 80 } }
]

{
  <variable_name_1>: <expression_1>,
  ...,
  <variable_name_n>: <expression_n>
}

返回：

该方法返回包含以下内容的文档：

• 如果操作使用写关注来运行，则布尔值 acknowledged 为 true；如果已禁用写关注，则为 false

• matchedCount 包含匹配文档的数量

• modifiedCount 包含已修改文档的数量

• upsertedId ，包含用于已更新或插入的文档的 _id

• upsertedCount 包含更新或插入文档的数量

限制

• updateMany() 只应用于幂等操作。

更新插入

如果 upsert: true 且没有文档与 filter 匹配，db.collection.updateMany() 将基于 filter 和 update 参数创建一个新文档。

If you specify upsert: true on a sharded collection, you must include the full shard key in the filter. For information about db.collection.updateMany() behavior in sharded collections, see Sharded Collections.

请参阅使用 Upsert 更新多个文档。

使用更新操作符表达式文档进行更新

对于修改规范，db.collection.updateMany() 方法可接受仅含有要执行的更新操作符表达式的文档。

例如：

db.collection.updateMany(
   <query>,
   { $set: { status: "D" }, $inc: { quantity: 2 } },
   ...
)

使用聚合管道进行更新

db.collection.updateMany() 方法可以接受指定要执行的修改的聚合管道 [ <stage1>, <stage2>, ... ]。该管道可以由以下阶段组成：

• $addFields 及其别名 $set

• $project 及其别名 $unset

• $replaceRoot 及其别名 $replaceWith

使用聚合分析管道可以进行更具表现力的更新声明，例如基于当前字段值的Express条件更新或使用另一个字段的值更新一个字段。

例如：

db.collection.updateMany(
   <query>,
   [
      { $set: { status: "Modified", comments: [ "$misc1", "$misc2" ] } },
      { $unset: [ "misc1", "misc2" ] }
   ]
   ...
)

有关示例，请参阅使用聚合管道进行更新。

固定大小集合

如果更新操作更改了文档大小，则操作将失败。

时间序列集合

从 MongoDB 5.1 开始，updateMany() 方法可用于 时间序列集合。

更新命令必须满足以下要求：

• 您只能匹配 metaField 字段值。

• 您只能修改 metaField 字段值。

• 您的更新文档只能包含更新操作符表达式。

• Your update command must not limit the number of documents to be updated. Set multi: true or use the updateMany() method.

• 更新命令不得设置 upsert: true。

分片集合

updateMany() 与分片的一起使用时会表现出以下行为：

• updateMany() 包含 upsert: true 的操作必须在 filter 中包含完整的分片键。

• If you attempt to run updateMany() during a Range Migration or a shard key value update, the operation can miss documents in some scenarios. To ensure all documents are updated, use idempotent updates and rerun the command until no further updates are applied. For more information on idempotent updates with updateMany(), see Idempotent Updates.

• 如果updateMany()在事务之外运行，针对多个分片的操作会将该操作广播到集群中的所有分片。

• 如果 updateMany() 在ACID 事务中运行，则针对多个分片的操作仅针对相关分片。

可解释性

updateMany() 与db.collection.explain() 不兼容。

事务

db.collection.updateMany() 可用于分布式事务。

Oplog 条目

updateMany() 为每个成功更新的文档在oplog （操作日志）中添加一个条目。如果没有文档更新，则 updateMany() 不会向oplog添加条目。

Idempotent Updates

sample_mflix.movies集合包含具有 IMDB 评级的电影。此幂等更新执行以下操作：

• 匹配 IMDB 评分小于 3.0 的所有电影

• 将这些评分递增 0.5

• 将 ratingBoosted字段设置为 true

db.movies.updateMany(
   { "imdb.rating": { $lt: 3, $type: "number" }, ratingBoosted: { $ne: true } },
   { $inc: { "imdb.rating": 0.5 }, $set: { ratingBoosted: true } }
)

updateMany() 单独修改匹配的电影文档。单个文档更新是原子操作，但 updateMany() 操作作为一个整体不是原子操作。

如果该操作无法更新所有匹配的文档，您可以安全地重新运行幂等命令，直到没有其他文档与指定的过滤匹配。 在这种情况下，每个文档的 imdb.rating字段仅更新一次，无论重试多少次，因为该命令是幂等的。

更新多个文档

sample_mflix.movies集合包含具有 num_mflix_comments字段的电影。

以下操作会查找所有评论超过 100 的电影，并为这些电影添加 popular 标志：

db.movies.updateMany( 
   { num_mflix_comments: { $gt: 100 } }, 
   { $set: { "popular" : true } } 
)

使用聚合管道进行更新

db.collection.updateMany() can use an aggregation pipeline to express a more complex update, such as a conditional update based on current field values. For the supported pipeline stages, see Update with an Aggregation Pipeline.

db.movies.updateMany(
   { year: { $gte: 2010, $lte: 2019 } },
   [
      { $set: { 
         combinedRatings: [ "$imdb.rating", "$tomatoes.viewer.rating" ], 
         ratingsUpdated: "$$NOW" 
      } },
      { $unset: [ "imdb.rating", "tomatoes.viewer.rating" ] }
   ]
)

db.movies.updateMany(
   { 
      year: { $gte: 2010, $lte: 2019 },
      "imdb.rating": { $exists: true },
      "tomatoes.viewer.rating": { $exists: true }
   },
   [
     { $set: { 
        combinedScore: { $trunc: [ 
           { $avg: [ "$imdb.rating", "$tomatoes.viewer.rating" ] }, 
           1 
        ] },
        scoreUpdated: "$$NOW" 
     } },
     { $set: { 
        ratingGrade: { $switch: {
           branches: [
              { case: { $gte: [ "$combinedScore", 8 ] }, then: "A" },
              { case: { $gte: [ "$combinedScore", 6 ] }, then: "B" },
              { case: { $gte: [ "$combinedScore", 4 ] }, then: "C" },
              { case: { $gte: [ "$combinedScore", 2 ] }, then: "D" }
           ],
           default: "F"
        } } 
     } }
   ]
)

使用更新或插入来更新多个文档。

以下操作会更新 2020 之后上映且由 Christopher Nolan 执导的所有电影：

db.movies.updateMany(
   { 
      year: { $gt: 2020 }, 
      directors: "Christopher Nolan" 
   },
   { $set: { "upcomingRelease": true } },
   { upsert: true }
)

在此示例中，由于没有文档与过滤器匹配，且 upsert 为 true，因此 updateMany 会插入一个新文档，其中包含生成的 _id 以及来自 filter 的相等条件和 update 修饰符。

使用写关注更新

给定一个三成员副本集，以下操作指定 majority 的 w 和 100 的 wtimeout：

db.movies.updateMany(
    { title: "The Godfather" },
    { $inc: { num_mflix_comments: 10 }, $set: { trending: true } },
    { w: "majority", wtimeout: 100 }
)

如果确认花费的时间超过 wtimeout 限制， MongoDB将引发异常。

下表解释了 errInfo.writeConcern.provenance 的可能值：

指定排序规则。

排序规则允许用户为字符串比较指定特定于语言的规则，例如字母大小写和重音符号规则。

以下操作使用不区分大小写的排序规则来匹配具有小写和大写任意组合的类型为“戏剧”的电影。

db.movies.updateMany(
   { genres: "drama" },
   { $set: { genreNormalized: true } },
   { collation: { locale: "en", strength: 1 } }
)

为数组更新操作指定 arrayFilters

更新数组字段时，您可以指定 arrayFilters 确定要更新哪些数组元素。

db.movies.updateMany(
   { 
      "imdb.rating": { $exists: true },
      "tomatoes.viewer.rating": { $exists: true },
      "tomatoes.critic.rating": { $exists: true },
      year: { $gte: 2010, $lte: 2015 }
   },
   [
      { $set: { 
         ratings: [
            { $multiply: ["$imdb.rating", 10] },
            { $multiply: ["$tomatoes.viewer.rating", 10] },
            { $multiply: ["$tomatoes.critic.rating", 10] }
         ]
      } }
   ]
)

db.movies.updateMany(
   { ratings: { $gte: 100 } },
   { $set: { "ratings.$[element]" : 100 } },
   { arrayFilters: [ { "element": { $gte: 100 } } ] }
)

db.movies.updateMany(
   { 
      "imdb.rating": { $exists: true },
      "tomatoes.viewer.rating": { $exists: true },
      year: { $gte: 2010, $lte: 2012 }
   },
   [
      { $set: { 
         ratingDetails: [
            { source: "imdb", score: "$imdb.rating", weight: 10 },
            { source: "tomatoes_viewer", score: "$tomatoes.viewer.rating", weight: 8 },
            { source: "tomatoes_critic", score: "$tomatoes.critic.rating", weight: 7 }
         ]
      } }
   ]
)

db.movies.updateMany(
   { ratingDetails: { $exists: true } },
   { $set: { "ratingDetails.$[elem].weight" : 10 } },
   { arrayFilters: [ { "elem.score": { $gte: 8 } } ] }
)

为更新操作指定 hint

在集合上创建以下索引：

db.movies.createIndex( { rated: 1 } )

以下更新操作明确提示使用索引 { rated: 1 }：

db.movies.updateMany(
   { "num_mflix_comments": { $lte: 5 }, "rated": "G" }, 
   { $set: { "familyFriendly": true } },
   { hint: { rated: 1 } }
)

要查看是否使用提示索引，运行 $indexStats 管道：

db.movies.aggregate( [ { $indexStats: { } }, { $sort: { name: 1 } }, { $match: {key: { rated: 1 } } } ] )

分片集群中的写关注错误

当 db.collection.updateMany() 在分片集群中的mongos上执行时，即使出现一个或多个其他错误，响应中也始终会报告 writeConcernError。在以前的版本中，其他错误有时会导致 db.collection.updateMany() 不报告写关注（write concern）错误。

示例，如果文档验证失败，触发 DocumentValidationFailed 错误，并且还发生写关注（write concern）错误，则 DocumentValidationFailed 错误和 writeConcernError 都会在响应的顶级字段中返回。

用户角色和文档更新

从 MongoDB 7.0 开始，您可以使用新的 USER_ROLES 系统变量来返回用户角色。

本部分中的示例展示了包含医疗信息的集合中的字段更新。该示例从 USER_ROLES 系统变量中读取当前用户角色，并且仅在用户具有特定角色时才执行更新。

要使用系统变量，请将$$添加到变量名称的开头。将USER_ROLES系统变量指定为$$USER_ROLES。

该示例创建这些用户：

• James 角色为 Billing。

• Michelle 角色为 Provider。

执行以下步骤以创建角色、用户和集合：

db.createRole( { role: "Billing", privileges: [ { resource: { db: "test",
   collection: "medicalView" }, actions: [ "find" ] } ], roles: [ ] } )
db.createRole( { role: "Provider", privileges: [ { resource: { db: "test",
   collection: "medicalView" }, actions: [ "find" ] } ], roles: [ ] } )

db.createUser( {
   user: "James",
   pwd: "js008",
   roles: [
      { role: "Billing", db: "test" }
   ]
} )
db.createUser( {
   user: "Michelle",
   pwd: "me009",
   roles: [
      { role: "Provider", db: "test" }
   ]
} )

db.medical.insertMany( [
   {
      _id: 0,
      patientName: "Jack Jones",
      diagnosisCode: "CAS 17",
      creditCard: "1234-5678-9012-3456"
   },
   {
      _id: 1,
      patientName: "Mary Smith",
      diagnosisCode: "ACH 01",
      creditCard: "6541-7534-9637-3456"
   }
] )

以角色为 Provider 的 Michelle 身份登录，然后执行更新：

db.auth( "Michelle", "me009" )

// Attempt to update many documents
db.medical.updateMany(
   // User must have the Provider role to perform the update
   { $expr: { $ne: [ {
      $setIntersection: [ [ "Provider" ], "$$USER_ROLES.role" ] }, []
   ] } },
   // Update diagnosisCode
   { $set: { diagnosisCode: "ACH 02"} }
)

前面的示例使用 $setIntersection 返回文档，其中，"Provider" 字符串与 $$USER_ROLES.role 中的用户角色之间的交集不为空。Michelle 的角色为 Provider，因此，将执行更新。

接下来，以不具有 Provider 角色的 James 身份登录，并尝试执行相同更新：

db.auth( "James", "js008" )

// Attempt to update many documents
db.medical.updateMany(
   // User must have the Provider role to perform the update
   { $expr: { $ne: [ {
      $setIntersection: [ [ "Provider" ], "$$USER_ROLES.role" ] }, []
   ] } },
   // Update diagnosisCode
   { $set: { diagnosisCode: "ACH 02"} }
)

前面的示例没有更新任何文档。