$ [<标识符>]_MonogDB 中文网

MongoDB 中文手册

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

在本页面

定义
行为
例子

定义¶

$[<identifier>]¶

3.6版的新功能。

过滤后的位置运算符$[<identifier>]标识与arrayFilters条件匹配的数组元素以进行更新操作，例如db.collection.update()和 db.collection.findAndModify()。

与该arrayFilters选项结合使用， $[<identifier>]运算符具有以下形式：

复制

{ <update operator>: { "<array>.$[<identifier>]" : value } },
{ arrayFilters: [ { <identifier>: <condition> } ] }

与该arrayFilters选项结合使用，以更新一个或多个与查询条件匹配的文档中所有与arrayFilters条件匹配的元素。例如：

复制

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

注意

在<identifier>必须以小写字母开头，并且只包含字母数字字符。

有关示例，请参见更新与arrayFilters匹配的所有数组元素。

行为¶

`upsert`¶

如果upsert操作导致插入，则query必须在array字段上包含完全相等的匹配项才能$[<identifier>]在update语句中使用。

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

复制

db.collection.update(
   { myArray: [ 0, 1 ] },
   { $set: { "myArray.$[element]": 2 } },
   { arrayFilters: [ { element: 0 } ],
     upsert: true }
)

如果不存在这样的文档，则该操作将导致插入类似于以下内容的文档：

复制

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

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

复制

db.array.update(
   { },
   { $set: { "myArray.$[element]": 10 } },
   { arrayFilters: [ { element: 9 } ],
     upsert: true }
)

该操作将返回类似于以下内容的错误：

复制

WriteResult({
   "nMatched" : 0,
   "nUpserted" : 0,
   "nModified" : 0,
   "writeError" : {
      "code" : 2,
      "errmsg" : "The path 'myArray' must exist in the document in order to apply array updates."
   }
})

嵌套数组¶

过滤后的位置运算符$[<identifier>]可用于遍历多个数组和嵌套数组的查询。

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

例子¶

更新所有的数组元素匹配`arrayFilters`¶

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

复制

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

要更新是大于或等于所有元素100中 grades阵列中，使用过滤的位置操作者 $[<identifier>]与arrayFilters：

复制

db.students.update(
   { },
   { $set: { "grades.$[element]" : 100 } },
   { multi: true,
     arrayFilters: [ { "element": { $gte: 100 } } ]
   }
)

位置$[<identifier>]运算符充当数组字段中与arrayFilters中指定的条件匹配的所有元素的占位符。

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

复制

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

更新`arrayFilters`数组中所有匹配的文档¶

该$[<identifier>]操作有利于更新包含嵌入文档数组。要访问嵌入文档中的字段，使用点符号上$[<identifier>]。

复制

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

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

复制

{
   "_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 }
   ]
}

要修改等级大于或等于mean的grades数组中所有元素的字段值85，请使用位置$[<identifier>]运算符和 arrayFilters：

复制

db.students2.update(
   { },
   { $set: { "grades.$[elem].mean" : 100 } },
   {
     multi: true,
     arrayFilters: [ { "elem.grade": { $gte: 85 } } ]
   }
)

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

复制

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

更新匹配多个条件的所有数组元素¶

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

复制

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

要修改数组中所有等级大于等于且大于等于的 std元素的字段值，请使用位置运算符和arrayFilters：grades80std5$[<identifier>]

复制

db.students2.update(
   { },
   { $inc: { "grades.$[elem].std" : -1 } },
   { arrayFilters: [ { "elem.grade": { $gte: 80 }, "elem.std": { $gt: 5 } } ], multi: true }
)

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

复制

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

使用负运算符更新数组元素¶

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

复制

{
   "_id": 1,
   "name": "Christine Franklin",
   "degrees": [
      { "level": "Master",
        "major": "Biology",
        "completion_year": 2010,
        "faculty": "Science"
      },
      {
        "level": "Bachelor",
        "major": "Biology",
        "completion_year": 2008,
        "faculty": "Science"
      }
   ],
   "school_email": "cfranklin@example.edu",
   "email": "christine@example.com"
}
{
   "_id": 2,
   "name": "Reyansh Sengupta",
   "degrees": [
      { "level": "Bachelor",
        "major": "Chemical Engineering",
        "completion_year": 2002,
        "faculty": "Engineering"
      }
   ],
   "school_email": "rsengupta2@example.edu"
}

要修改degrees数组中所有没有的元素，请对查询运算符使用位置运算："level": "Bachelor"[<identifier>]$ne

复制

db.alumni.update(
   { },
   { $set : { "degrees.$[degree].gradcampaign" : 1 } },
   { arrayFilters : [ {"degree.level" : { $ne: "Bachelor" } } ],
     multi : true }
)

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

复制

{
   "_id" : 1,
   "name" : "Christine Franklin",
   "degrees" : [
      {
         "level" : "Master",
         "major" : "Biology",
         "completion_year" : 2010,
         "faculty" : "Science",
         "gradcampaign" : 1
      },
      {
         "level" : "Bachelor",
         "major" : "Biology",
         "completion_year" : 2008,
         "faculty" : "Science"
      }
   ],
   "school_email" : "cfranklin@example.edu",
   "email" : "christine@example.com"
}
{
   "_id" : 2,
   "name" : "Reyansh Sengupta",
   "degrees" : [
      {
         "level" : "Bachelor",
         "major" : "Chemical Engineering",
         "completion_year" : 2002,
         "faculty" : "Engineering"
      }
   ],
   "school_email" : "rsengupta2@example.edu"
}

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

所述$[<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数组中的 grades.type值quiz。

复制

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

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

复制

{
   "_id" : 1,
   "grades" : [
      { "type" : "quiz", "questions" : [ 12, 10, 5 ] },
      { "type" : "quiz", "questions" : [ 10, 11, 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}
)

也可以看看

MongoDB 中文手册

$ [<标识符>]

定义¶

行为¶

upsert¶

嵌套数组¶

例子¶

更新所有的数组元素匹配arrayFilters¶

更新arrayFilters数组中所有匹配的文档¶

更新匹配多个条件的所有数组元素¶

使用负运算符更新数组元素¶

与¶一起更新嵌套数组$[]

`upsert`¶

更新所有的数组元素匹配`arrayFilters`¶

更新`arrayFilters`数组中所有匹配的文档¶

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