$ []_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 更新运算符 > 数组更新运算符 > $ []

在本页面

定义
行为
例子

定义¶

$[]¶

3.6版的新功能。

all位置运算符$[]指示update运算符应修改指定数组字段中的所有元素。

该$[]经营者具有下列形式：

复制

{ <update operator>: { "<array>.$[]" : value } }

用于更新操作（例如db.collection.update()和 db.collection.findAndModify()）来修改一个或多个查询条件匹配的文档的所有数组元素。例如：

复制

db.collection.updateMany(
   { <query conditions> },
   { <update operator>: { "<array>.$[]" : value } }
)

有关示例，请参见更新数组中的所有元素。

行为¶

`upsert`¶

如果upsert操作导致插入，则query必须在array字段上包含完全相等的匹配项，以便$[]在update语句中使用位置运算符。

例如，$[]在更新文档中使用的以下upsert操作在array字段上指定完全相等的匹配条件：

复制

db.collection.update(
   { myArray: [ 5, 8 ] },
   { $set: { "myArray.$[]": 10 } },
   { upsert: true }
)

如果不存在此类文档，则该操作将导致插入以下文档：

复制

{ "_id" : ObjectId(...), "myArray" : [ 10, 10 ] }

如果upsert操作不包括完全相等的匹配项，并且找不到匹配的文档要更新，则upsert操作将出错。

例如，如果找不到匹配的文档来更新，则以下操作将出错：

复制

db.collection.update(
   { myArray: 5 },
   { $set: { "myArray.$[]": 10 } },
   { upsert: true }
)

db.collection.update(
   { },
   { $set: { "myArray.$[]": 10 } },
   { upsert: true }
)

嵌套数组¶

该$[]运算符可用于遍历多个数组和嵌套数组的查询。

有关示例，请参见使用$ [<identifier>]联合更新嵌套数组。

例子¶

更新数组中的所有元素¶

考虑students包含以下文档的集合：

复制

{ "_id" : 1, "grades" : [ 85, 82, 80 ] }
{ "_id" : 2, "grades" : [ 88, 90, 92 ] }
{ "_id" : 3, "grades" : [ 85, 100, 90 ] }

要为集合中的所有文档增加grades数组中的所有元素10，请使用all位置$[] 运算符：

复制

db.students.update(
   { },
   { $inc: { "grades.$[]": 10 } },
   { multi: true }
)

全位置$[]运算符充当数组字段中所有元素的占位符。

操作后，students集合包含以下文档：

复制

{ "_id" : 1, "grades" : [ 95, 92, 90 ] }
{ "_id" : 2, "grades" : [ 98, 100, 102 ] }
{ "_id" : 3, "grades" : [ 95, 110, 100 ] }

更新数组中的所有文档¶

该$[]位置操作方便的更新包含嵌入文档数组。要访问嵌入文档中的字段，请在运算符上使用点符号 $[]。

复制

db.collection.update(
   { <query selector> },
   { <update operator>: { "array.$[].field" : value } }
)

考虑students2包含以下文档的集合：

复制

{
   "_id" : 1,
   "grades" : [
      { "grade" : 80, "mean" : 75, "std" : 8 },
      { "grade" : 85, "mean" : 90, "std" : 6 },
      { "grade" : 85, "mean" : 85, "std" : 8 }
   ]
}
{
   "_id" : 2,
   "grades" : [
      { "grade" : 90, "mean" : 75, "std" : 8 },
      { "grade" : 87, "mean" : 90, "std" : 5 },
      { "grade" : 85, "mean" : 85, "std" : 6 }
   ]
}

要修改数组中std所有元素的字段值grades，请使用位置$[]运算符：

复制

db.students2.update(
   { },
   { $inc: { "grades.$[].std" : -2 } },
   { multi: true }
)

操作后，集合具有以下文档：

复制

{
   "_id" : 1,
   "grades" : [
      { "grade" : 80, "mean" : 75, "std" : 6 },
      { "grade" : 85, "mean" : 90, "std" : 4 },
      { "grade" : 85, "mean" : 85, "std" : 6 }
   ]
}
{
   "_id" : 2,
   "grades" : [
      { "grade" : 90, "mean" : 75, "std" : 6 },
      { "grade" : 87, "mean" : 90, "std" : 3 },
      { "grade" : 85, "mean" : 85, "std" : 4 }
   ]
}

更新阵列指定使用否定查询运算符¶

考虑results包含以下文档的集合：

复制

{ "_id" : 1, "grades" : [ 85, 82, 80 ] }
{ "_id" : 2, "grades" : [ 88, 90, 92 ] }
{ "_id" : 3, "grades" : [ 85, 100, 90 ] }

递增中的所有元素grades由阵列10的所有文件，除了那些值100中grades 阵列中，使用所有的位置$[]操作者：

复制

db.results.update(
   { "grades" : { $ne: 100 } },
   { $inc: { "grades.$[]": 10 } },
   { multi: true }
)

全位置$[]运算符充当数组字段中所有元素的占位符。

操作后，students集合包含以下文档：

复制

{ "_id" : 1, "grades" : [ 95, 92, 90 ] }
{ "_id" : 2, "grades" : [ 98, 100, 102 ] }
{ "_id" : 3, "grades" : [ 85, 100, 90 ] }

与¶一起更新嵌套数组`$[<identifier>]`

的$[]位置操作，在与过滤器结合 $[<identifier>]的位置操作者可以被用于更新嵌套阵列。

students3使用以下文档创建一个集合：

复制

db.students3.insert([
   { "_id" : 1,
      "grades" : [
        { type: "quiz", questions: [ 10, 8, 5 ] },
        { type: "quiz", questions: [ 8, 9, 6 ] },
        { type: "hw", questions: [ 5, 4, 3 ] },
        { type: "exam", questions: [ 25, 10, 23, 0 ] },
      ]
   }
])

要更新所有大于或等于8嵌套grades.questions数组中的值，无论如何type：

复制

db.students3.update(
   {},
   { $inc: { "grades.$[].questions.$[score]": 2 } },
   { arrayFilters: [  { "score": { $gte: 8 } } ], multi: true}
)

也可以看看