$（更新）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 更新运算符 > 数组更新运算符 > $（更新）

在本页面

定义
行为
例子

定义¶

$¶

位置$运算符标识要更新的数组中的元素，而无需显式指定数组中元素的位置。

消歧

要通过读取操作$投影或返回数组元素，请参阅投影运算符。
要更新数组中的所有元素，请参阅all位置运算符 $[]。
要更新所有符合一个或多个数组过滤条件的元素，请参阅过滤后的位置运算符 $[<identifier>]。

位置$运算符的格式为：

复制

{ "<array>.$" : value }

与更新操作（例如 db.collection.update()和 db.collection.findAndModify()）一起使用时

位置$运算符充当与匹配的第一个元素的占位符，并且query document
该array字段必须显示为的一部分。query document

例如：

复制

db.collection.update(
   { <array>: value ... },
   { <update operator>: { "<array>.$" : value } }
)

行为¶

`upsert`¶

不要将位置运算符$与 upsert操作一起使用，因为插入将$在插入的文档中将用作字段名。

嵌套数组¶

位置$运算符不能用于遍历一个以上数组的查询，例如遍历嵌套在其他数组中的数组的查询，因为$占位符的替换是单个值

取消设置¶

与$unset运算符一起使用时，位置 $运算符不会从数组中删除匹配的元素，而是将其设置为null。

否定¶

如果查询使用否定运算符，如阵列相匹配 $ne，$not或者$nin，那么你就不能使用位置运营商更新值从该数组。

但是，如果查询的否定部分在$elemMatch表达式内部，则可以使用位置运算符更新此字段。

例子¶

数组中的更新值¶

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

复制

db.students.insert([
   { "_id" : 1, "grades" : [ 85, 80, 80 ] },
   { "_id" : 2, "grades" : [ 88, 90, 92 ] },
   { "_id" : 3, "grades" : [ 85, 100, 90 ] }
])

要更新的第一个元素，它的值是80要82在中grades排列，使用位置$操作，如果你不知道数组中元素的位置：

重要

您必须将数组字段包含在query文档中。

复制

db.students.updateOne(
   { _id: 1, grades: 80 },
   { $set: { "grades.$" : 82 } }
)

位置$运算符充当更新查询文档的第一个匹配项的占位符。

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

复制

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

更新数组中的文档¶

位置$运算符有助于更新包含嵌入式文档的数组。使用位置$ 操作者进入场中嵌入文档用点号的 $运营商。

复制

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

请考虑students集合中的以下文档，该文档的 grades元素值为嵌入式文档的数组：

复制

{
  _id: 4,
  grades: [
     { grade: 80, mean: 75, std: 8 },
     { grade: 85, mean: 90, std: 5 },
     { grade: 85, mean: 85, std: 8 }
  ]
}

使用位置$运算符更新std匹配grade等于85 条件的第一个数组元素的字段：

重要

您必须将数组字段包含在query文档中。

复制

db.students.updateOne(
   { _id: 4, "grades.grade": 85 },
   { $set: { "grades.$.std" : 6 } }
)

操作后，文档具有以下更新值：

复制

{
   "_id" : 4,
   "grades" : [
      { "grade" : 80, "mean" : 75, "std" : 8 },
      { "grade" : 85, "mean" : 90, "std" : 6 },
      { "grade" : 85, "mean" : 85, "std" : 8 }
   ]
}

使用多个字段匹配更新嵌入式文档¶

的$操作者可以更新匹配与指定的多个查询条件的第一个数组元素$elemMatch()运营商。

考虑students集合中的以下文档，该文档的 grades字段值为嵌入式文档的数组：

复制

{
  _id: 5,
  grades: [
     { grade: 80, mean: 75, std: 8 },
     { grade: 85, mean: 90, std: 5 },
     { grade: 90, mean: 85, std: 3 }
  ]
}

在下面的示例中，$操作员更新std第一个嵌入式文档中的字段值，该字段grade的值小于或等于，90而mean字段的值大于80：

复制

db.students.updateOne(
   {
     _id: 5,
     grades: { $elemMatch: { grade: { $lte: 90 }, mean: { $gt: 80 } } }
   },
   { $set: { "grades.$.std" : 6 } }
)

此操作将更新符合条件的第一个嵌入式文档，即数组中的第二个嵌入式文档：

复制

{
  _id: 5,
  grades: [
    { grade: 80, mean: 75, std: 8 },
    { grade: 85, mean: 90, std: 6 },
    { grade: 90, mean: 85, std: 3 }
  ]
}

也可以看看

db.collection.update()， db.collection.findAndModify()，$elemMatch()

MongoDB 中文手册

$（更新）

定义¶

行为¶

upsert¶

嵌套数组¶

取消设置¶

否定¶

例子¶

数组中的更新值¶

更新数组中的文档¶

使用多个字段匹配更新嵌入式文档¶

`upsert`¶