AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

フィールドパス

入力ドキュメント内のフィールドにアクセスするには、フィールドパス式を使用します。フィールド名または、埋め込みドキュメントの場合は、ドット表記のフィールドパスの前にドル記号 $ を付けます。

次の例では、 Atlas サンプルデータベース の planets コレクションを使用します。このコレクション内の各ドキュメントの構造は次のとおりです。

{ _id: new ObjectId("6220f6b78a733c51b416c80e"), name: "Uranus", orderFromSun: 7, hasRings: true, mainAtmosphere: [ "H2", "He", "CH4" ], surfaceTemperatureC: { min: null, max: null, mean: -197.2 }}

surfaceTemperatureC 内のネストされた mean フィールドを指定するには、ドルとともにドット表記 ("field.nestedField") を使用します $。この集計パイプラインは、各ドキュメントの mean ネストされたフィールド値のみをプロジェクトします。

db.planets.aggregate( [ { $project: { nested_field: "$surfaceTemperatureC.mean" } }] )

返されたドキュメントの例:

{ _id: ObjectId('6220f6b78a733c51b416c80e'), nested_field: -197.2 }

フィールドパス内の ドット表記を使用して、配列内にネストされたフィールドにアクセスします。例えば、instockフィールドにネストされた warehouseフィールドの配列が含まれている productsコレクションを考えてみましょう。

db.products.insertMany( [ { item: "journal", instock: [ { warehouse: "A"}, { warehouse: "C" } ] }, { item: "notebook", instock: [ { warehouse: "C" } ] }, { item: "paper", instock: [ { warehouse: "A" }, { warehouse: "B" } ] }, { item: "planner", instock: [ { warehouse: "A" }, { warehouse: "B" } ] }, { item: "postcard", instock: [ { warehouse: "B" }, { warehouse: "C" } ] }] )

次の集計パイプラインは$instock.warehouse を使用してネストされた warehouse フィールドにアクセスします。

db.products.aggregate( [ { $project: { item: 1, warehouses: "$instock.warehouse" } }] )

この例では 、$instock.warehouse は、各ドキュメントのネストされた warehouseフィールドにある値の配列を出力します。 パイプラインは次のドキュメントを返します。

[ { _id: ObjectId('6740b55e33b29cf6b1d884f7'), item: "journal", warehouses: [ "A", "C" ] }, { _id: ObjectId('6740b55e33b29cf6b1d884f8'), item: "notebook", warehouses: [ "C" ] }, { _id: ObjectId('6740b55e33b29cf6b1d884f9'), item: "paper", warehouses: [ "A", "B" ] }, { _id: ObjectId('6740b55e33b29cf6b1d884fa'), item: "planner", warehouses: [ "A", "B" ] }, { _id: ObjectId('6740b55e33b29cf6b1d884fb'), item: "postcard", warehouses: [ "B", "C" ] }]

また、フィールドパスにドル記号 $ を含むドット表記を使用して、ネストされた配列内の配列にアクセスすることもできます。次の例では、このドキュメントを含む fruits コレクションを使用します。

db.fruits.insertOne( { _id: ObjectId("5ba53172ce6fa2fcfc58e0ac"), inventory: [ { apples: [ "macintosh", "golden delicious", ] }, { oranges: [ "mandarin", ] }, { apples: [ "braeburn", "honeycrisp", ] } ] })

次の集計パイプラインは、inventory 内のネストされた apples 配列にアクセスします。

db.fruits.aggregate( [ { $project: { all_apples: "$inventory.apples" } }] )

このパイプラインでは、$inventory.apples はネストされた配列の配列に解決されます。 パイプラインは、次のドキュメントを返します。

{ _id: ObjectId('5ba53172ce6fa2fcfc58e0ac'), all_apples: [ [ "macintosh", "golden delicious" ], [ "braeburn", "honeycrisp" ] ]}

ネストされた要素へのアクセスと操作の詳細については、 ドット表記 および 埋め込みドキュメントの配列のクエリ を参照してください。