ピリオドを含むフィールド名

ピリオドを含むフィールド名を挿入

ピリオドのあるフィールド名を含むドキュメントを挿入するには、フィールド名を引用符で囲みます。

次のコマンドは、フィールド名 price.usdを含むドキュメントを挿入します。

db.inventory.insertOne(
   {
      "item" : "sweatshirt",
      "price.usd": 45.99,
      "quantity": 20
   }
)

ピリオドのあるフィールドのクエリ

期間を持つフィールドをクエリするには、 $getField演算子を使用します。

次のクエリは、 price.usdフィールドが40より大きいドキュメントを返します。

db.inventory.find(
   {
      $expr:
         {
            $gt: [ { $getField: "price.usd" }, 40 ]
         }
   }
)

[
   {
      _id: ObjectId("66145f9bcb1d4abffd2f1b50"),
      item: 'sweatshirt',
      'price.usd': 45.99,
      quantity: 20
   }
]

$getFieldを使用しない場合、MongoDB はピリオドを含むフィールド名を埋め込みオブジェクトとして扱います。 たとえば、次のクエリは、 priceフィールド内のusdフィールドが40より大きいドキュメントに一致します。

db.inventory.find( {
   "price.usd": { $gt: 40 }
} )

上記のクエリは、次のドキュメントと一致します。

{
   "item" : "sweatshirt",
   "price": {
      "usd": 45.99
   },
   "quantity": 20
}

期間内のフィールドを更新

期間を持つフィールドを更新するには、 $setField演算子を使用した集計パイプラインを使用します。

次の操作は、 price.usdフィールドを29.99に設定します。

db.inventory.updateOne(
   { "item": "sweatshirt" },
   [
      {
         $replaceWith: {
            $setField: {
               field: "price.usd",
               input: "$$ROOT",
               value: 29.99
            }
         }
      }
   ]
)

$setFieldを使用しない場合、MongoDB はピリオドを含むフィールド名を埋め込みオブジェクトとして扱います。 たとえば、次の操作では、既存のprice.usdフィールドは更新されず、代わりにpriceフィールド内に埋め込まれた新しいフィールドusdが挿入されます。

db.inventory.updateOne(
   { "item": "sweatshirt" },
   { $set: { "price.usd": 29.99 } }
)

結果ドキュメント:

[
   {
      _id: ObjectId("66145f9bcb1d4abffd2f1b50"),
      item: 'sweatshirt',
      'price.usd': 45.99
      quantity: 20,
      price: { usd: 29.99 }
   }
]

集計パイプラインによる更新のその他の例については、「 集約パイプラインによる更新 」を参照してください。

あいまいなフィールド名を回避

埋め込みフィールドのドット表記と同じ名フィールド名は使用しないでください。埋め込みフィールド { "a" : { "b": ... } } を持つドキュメントがある場合、そのコレクション内の他のドキュメントはトップレベルフィールド "a.b" を保持してはいけません。

埋め込みフィールドと最上位フィールドを同じ方法で参照できる場合、インデックス作成とシャーディング操作は埋め込みフィールドの で行われます。同じ方法で参照埋め込みフィールドがコレクションにある間は、最上位フィールド"a.b" のインデックスやシャードはできません。

例、コレクションに埋め込みフィールド{ "a" : { "b": ... } } と最上位フィールド"a.b" の両方を持つドキュメントが含まれている場合、インデックス作成とシャーディング操作は埋め込みフィールドの で実行されます。コレクションに埋め込みフィールド{ "a" : { "b": ... } } も含まれている場合、最上位フィールド"a.b" のインデックスまたはシャードは実行できません。

詳細

• $getField

• $setField

• $literal

• ドル記号のプレフィックスがついたフィールド名