字段路径

本页内容

用例

了解更多

您可以使用字段路径表达式来访问输入文档中的字段。要指定字段路径，请使用美元符号作为字段名或点字段路径（如果字段位于嵌入文档中）的前缀$.

用例

您可以使用字段路径用于以下用例

嵌套字段
嵌套字段的数组
嵌套数组的数组

嵌套字段

以下示例使用了来自行星集合的Atlas 示例数据库。该集合中的每个文档具有以下结构

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

要指定 mean 字段中的嵌套字段，请使用点符号（"field.nestedField"）和美元符号（$）。以下聚合管道只投影每个文档的 mean 嵌套字段值

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

以下是一个返回文档的示例

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

嵌套字段的数组

您可以在字段路径中使用点表示法来访问嵌套在数组中的字段。

例如，考虑一个包含 instock 字段的 products 集合。该 instock 字段包含一个嵌套的 warehouse 字段数组。

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 数组，其中每个数组元素都是一个包含嵌套数组字段的对象。

考虑以下聚合管道

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

在此管道中，$inventory.apples 解析为一个嵌套数组的数组。管道返回以下文档

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

了解更多

有关访问和交互嵌套元素的信息，请参阅点表示法和查询嵌套文档的数组。

聚合管道

优化