/ /

フィールドパス

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

ネストされたフィールド

次の例では、 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" ]
   ]
}

詳細

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

戻る

Aggregation Pipeline

最適化