$mergeObjects
聚合运算符用于将多个文档合并为一个文档。可用于$bucket
、$bucketAuto
、$group
、$replaceRoot
等阶段。
语法
不同的阶段,语法略有不同,当在$bucket
、$bucketAuto
、$group
阶段使用时,语法为:
{ $mergeObjects: <document> }
当应用在表达式但不作为累加器时(包括$bucket
、$bucketAuto
、$group
阶段),语法为:
{ $mergeObjects: [ <document1>, <document2>, ... ] }
其中<document>
可以是任何能被解析为文档的表达式。
使用
$mergeObjects
忽略null操作数,如果所有的操作数都为null,$mergeObjects
返回一个空文档{}
。$mergeObjects
合并文档时,会使用最后一个合并的文档覆盖同名字段的值。
如:
{ $mergeObjects: [ { a: 1 }, null ] }
结果为:
{ a: 1 }
{ $mergeObjects: [ null, null ] }
结果为:
{}
{
$mergeObjects: [
{ a: 1 },
{ a: 2, b: 2 },
{ a: 3, c: 3 }
]
}
结果为:
{ a: 3, b: 2, c: 3 }
{
$mergeObjects: [
{ a: 1 },
{ a: 2, b: 2 },
{ a: 3, b: null, c: 3 }
]
}
结果为:
{ a: 3, b: null, c: 3 }
举例
$mergeObjects
使用下面的脚本分别创建orders
和items
集合:
db.orders.insertMany( [
{ "_id" : 1, "item" : "abc", "price" : 12, "ordered" : 2 },
{ "_id" : 2, "item" : "jkl", "price" : 20, "ordered" : 1 }
] )
db.items.insertMany( [
{ "_id" : 1, "item" : "abc", description: "product 1", "instock" : 120 },
{ "_id" : 2, "item" : "def", description: "product 2", "instock" : 80 },
{ "_id" : 3, "item" : "jkl", description: "product 3", "instock" : 60 }
] )
下面的聚合操作首先使用$lookup
阶段通过item
字段连接两个集合,然后使用$mergeObjects
在$replaceRoot
中合并来自items
和orders
的联接文档:
db.orders.aggregate( [
{
$lookup: {
from: "items",
localField: "item", //订单集合中的字段
foreignField: "item", //订单明细集合中的字段
as: "fromItems"
}
},
{
$replaceRoot: { newRoot: { $mergeObjects: [ { $arrayElemAt: [ "$fromItems", 0 ] }, "$$ROOT" ] } }
},
{ $project: { fromItems: 0 } }
] )
操作返回下面的结果:
{
_id: 1,
item: 'abc',
description: 'product 1',
instock: 120,
price: 12,
ordered: 2
},
{
_id: 2,
item: 'jkl',
description: 'product 3',
instock: 60,
price: 20,
ordered: 1
}
$mergeObjects作为累加器
使用下面的脚本创建sales
集合:
db.sales.insertMany( [
{ _id: 1, year: 2017, item: "A", quantity: { "2017Q1": 500, "2017Q2": 500 } },
{ _id: 2, year: 2016, item: "A", quantity: { "2016Q1": 400, "2016Q2": 300, "2016Q3": 0, "2016Q4": 0 } } ,
{ _id: 3, year: 2017, item: "B", quantity: { "2017Q1": 300 } },
{ _id: 4, year: 2016, item: "B", quantity: { "2016Q3": 100, "2016Q4": 250 } }
] )
下面的聚合操作在$group
阶段将$mergeObjects
作为累加器,按照item
字段进行分组:
db.sales.aggregate( [
{ $group: { _id: "$item", mergedSales: { $mergeObjects: "$quantity" } } }
] )
操作返回下面的结果:
{
_id: 'A',
mergedSales: { '2017Q1': 500, '2017Q2': 500, '2016Q1': 400, '2016Q2': 300, '2016Q3': 0, '2016Q4': 0 }
},
{
_id: 'B',
mergedSales: { '2017Q1': 300, '2016Q3': 100, '2016Q4': 250 }
}