以美元为前缀的字段名称

本节总结了不同的插入和更新操作如何处理美元 ($) 前缀的字段名称。MongoDB不鼓励使用以美元为前缀的字段名称，因为这些字段不支持某些功能。有关更多信息，请参阅一般限制。

插入操作

允许以美元 ($) 为前缀的字段作为插入操作的顶层和嵌套字段名。

db.sales.insertOne( {
   "$price": 50.00,
   "quantity": 30
} )

附带美元符号 ($) 前缀的字段可在使用其他保留字的插入操作中使用。$inc 一类的运算符名称以及类似 id、db 和 ref 的词可用作字段名称。

db.books.insertOne( {
   "$id": "h1961-01",
   "location": {
      "$db": "novels",
      "$ref": "2007042768",
      "$inc": true
} } )

对字段名验证而言，在更新或插入 (upsert) 期间创建新文档的更新被视为 insert 而非 update。upsert 可接受以美元符号 ($) 为前缀的字段。不过，upsert 是一种特例，如果更新中的 match 部分选择的是现有文档，类似的更新操作可能会引发错误。

此代码示例中包含 upsert: true，因此如果集合尚未包含与查询词 { "date": "2021-07-07" } 匹配的文档，MongoDB 会插入一份新文档。如果此示例代码与现有文档匹配，则更新失败，因为 $hotel 以美元符号 ($) 为前缀。

db.expenses.updateOne(
   { "date": "2021-07-07" },
   { $set: {
      "phone": 25.17,
      "$hotel": 320.10
   } },
   { upsert: true }
)

文档替换更新

更新操作符需要用新文档替换现有字段，或者修改这些字段。通过更新进行替换时，不得以美元 ( $ ) 前缀字段作为顶级字段名称。

考虑这样的文档

{
   "_id": "E123",
   "address": {
      "$number": 123,
      "$street": "Elm Road"
   },
   "$rooms": {
      "br": 2,
      "bath": 1
   }
}

您可以使用替换现有文档的更新操作符来修改 address.$street 字段，但不能以这种方式更新 $rooms 字段。

db.housing.updateOne(
   { "_id": "E123" },
   { $set: { "address.$street": "Elm Ave" } }
)

使用$setField作为聚合管道的一部分来更新顶级美元 ( $ ) 前缀字段，例如$rooms 。

文档修改更新

当更新修改而不是替换现有文档字段时，美元 ($) 前缀字段可以是顶级字段名称。可以直接访问子字段，但您需要一个辅助方法来访问顶级字段。

提示

$getField, $setField, $literal, $replaceWith

考虑包含此类库存记录文档的集合：

{
   _id: ObjectId("610023ad7d58ecda39b8d161"),
   "part": "AB305",
   "$bin": 200,
   "quantity": 100,
   "pricing": { sale: true, "$discount": 60 }
}

可以直接查询 pricing.$discount 子字段。

db.inventory.findAndModify( {
    query: { "part": { $eq: "AB305" } },
    update: { $inc: { "pricing.$discount": 10 } }
} )

使用 $getField 和 $literal 访问顶级 $bin 字段的值。

db.inventory.findAndModify( {
   query: { $expr: {
      $eq: [ { $getField: { $literal: "$bin" } }, 200 ]
   } },
   update: { $inc: { "quantity": 10 } }
} )

使用聚合管道进行更新。

在 $replaceWith 阶段使用 $setField、$getField 和 $literal 来修改聚合管道中以美元符号 ($) 为前缀的字段。

以类似以下内容的学校记录集合为例：

db.school.insertOne (
{
   "_id": 100001,
   "$term": "fall",
   "registered": true,
   "grade": 4
} )

使用管道为春季学期创建一个新集合，以便更新以美元符号 ($) 为前缀的 $term 字段。

db.school.aggregate( [
   { $match: { "registered": true } },
   { $replaceWith: {
      $setField: {
         field: { $literal: "$term" },
         input: "$$ROOT",
         value: "spring"
   } } },
   { $out: "spring2022" }
] )

后退

句点和美元符号

来年

带句点的字段名称