定义
语法
$documents 阶段具有以下形式：
{ $documents: <expression> }限制
您只能在数据库级聚合管道中使用
$documents。您必须使用
$documents作为聚合管道的第一阶段。
请参阅下面的使用示例。
行为
$documents 接受解析为对象数组的任何有效表达式。这包括：
无法解析为当前文档的表达式（如 $myField 或 $$ROOT）会导致错误。
示例
测试管道阶段
为管道阶段创建测试和调试数据，而无需创建测试集合。
db.aggregate( [ { $documents: [ { x: 10 }, { x: 2 }, { x: 5 } ] }, { $bucketAuto: { groupBy: "$x", buckets: 4 } } ])聚合表达式未指定集合。它使用突出显示的 $documents 阶段中的输入数据作为 $bucketAuto 阶段的输入。
[ { _id: { min: 2, max: 5 }, count: 1 }, { _id: { min: 5, max: 10 }, count: 1 }, { _id: { min: 10, max: 10 }, count: 1 }]在$documents $lookup阶段使用 阶段
使用 $documents 将集合中的文档与其他数据关联，从而修改 $lookup 输出。
创建 locations 集合。
db.locations.insertMany( [ { zip: 94301, name: "Palo Alto" }, { zip: 10019, name: "New York" } ] )将 $documents 作为数据源对文档进行转化。
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 管道阶段中的值进行关联。
[ { _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参数会创建一个新的输出字段
要使用MongoDB .NET/C# 驱动程序将 $documents 阶段添加到聚合管道，请对 PipelineDefinition 对象调用 UnionWith() 方法。
以下示例创建了一个管道阶段，该阶段创建了三个文档：
var documentArray = new[]{ new BsonDocument {{ "title", "The Shawshank Redemption" }}, new BsonDocument {{ "title", "Back to the Future" }}, new BsonDocument {{ "title", "Jurassic Park" }},};
var pipeline = new EmptyPipelineDefinition<NoPipelineInput>() .Documents(documentArray);要使用MongoDB Node.js驱动程序将 $documents 阶段添加到聚合管道，请在管道对象中使用 $documents操作符。
以下示例创建了一个管道阶段，该阶段创建了三个文档。然后，该示例运行聚合管道：
const pipeline = [ { $documents: [ { "title": "The Shawshank Redemption" }, { "title": "Back to the Future" }, { "title": "Jurassic Park" } ] }];
const cursor = collection.aggregate(pipeline);return cursor;了解详情
有关使用 $lookup 语法的子查询的详细信息，请参阅使用简洁事务语法的关联子查询。