$documents
阶段可以根据输入值返回字面意义的文档。
语法
js
{ $documents: <表达式> }
$documents
接受可解析为对象数组的任何有效表达式,包括:
-
系统变量,如
$$NOW
或$$SEARCH_META
-
$let
表达式 -
$lookup
表达式作用域中的变量
没有指向当前文档的表达式(如 $myField
或 $$ROOT
)将导致错误。
举例
测试管道阶段
下面例子为管道阶段创建测试和调试数据,无需创建测试集合。
js
db.aggregate(
[
{ $documents: [ { x: 10 }, { x: 2 }, { x: 5 } ] },
{ $bucketAuto: { groupBy: "$x", buckets: 4 } }
]
)
聚合表达式不指定集合。它使用$documents
阶段中的输入数据作为$bucketAuto
阶段的输入。
js
[
{ _id: { min: 2, max: 5 }, count: 1 },
{ _id: { min: 5, max: 10 }, count: 1 },
{ _id: { min: 10, max: 10 }, count: 1 }
]
在 $lookup 阶段使用 $documents 阶段
使用$documents
修改$lookup
的输出。
创建locations
集合:
js
db.locations.insertMany(
[
{ zip: 94301, name: "Palo Alto" },
{ zip: 10019, name: "New York" }
]
)
使用$documents
作为数据源来转换文件。
js
db.locations.aggregate(
[
{ $match: {} },
{ $lookup:
{
localField: "zip",
foreignField: "zip_id",
as: "city_state",
pipeline:
[
{ $documents:
[
{ zip_id: 94301, name: "Palo Alto, CA" },
{ zip_id: 10019, name: "New York, NY" }
]
}
]
}
}
]
)
输出将locations
集合中的数据与$documents
管道阶段中的值相关联。
js
[
{
_id: ObjectId("618949d60f7bfd5f5689490d"),
zip: 94301,
name: 'Palo Alto',
city_state: [ { zip_id: 94301, name: 'Palo Alto, CA' } ]
},
{
_id: ObjectId("618949d60f7bfd5f5689490e"),
zip: 10019,
name: 'New York',
city_state: [ { zip_id: 10019, name: 'New York, NY' } ]
}
]
-
zip
字段对应zip_id
字段 -
as
参数会创建一个新的输出字段