$replaceRoot (aggregation)
在本页面
Definition
$replaceRoot- 3.4 版的新功能。
将指定的文档提升到顶层，并替换所有其他字段。该操作将替换 Importing 文档中的所有现有字段，包括_id字段。您可以将现有的嵌入式文档升级到顶层，也可以创建一个新的文档进行升级(请参见example)。
$replaceRoot阶段具有以下形式：
{ $replaceRoot: { newRoot: <replacementDocument> } }
替换文档可以是解析为文档的任何有效expression。
有关表达式的更多信息，请参见Expressions。
Behavior
如果<replacementDocument>不是文档，则$replaceRoot操作将失败并显示错误。
如果替换文档引用了 Importing 文档中不存在的字段，则该操作将失败并显示错误。为了确保存在替换文档，请先使用$match阶段检查是否存在，然后再将文档传递到$replaceRoot阶段(请参见example)。
Examples
$ replaceRoot 带有嵌入式文档
名为produce的集合包含以下文档：
{
"_id" : 1,
"fruit" : [ "apples", "oranges" ],
"in_stock" : { "oranges" : 20, "apples" : 60 },
"on_order" : { "oranges" : 35, "apples" : 75 }
}
{
"_id" : 2,
"vegetables" : [ "beets", "yams" ],
"in_stock" : { "beets" : 130, "yams" : 200 },
"on_order" : { "beets" : 90, "yams" : 145 }
}
以下操作使用$replaceRoot阶段将in_stock文档提升到顶层，并丢弃当前的顶层字段。
db.produce.aggregate( [
{
$replaceRoot: { newRoot: "$in_stock" }
}
] )
该操作返回以下文档：
{ "oranges" : 20, "apples" : 60 }
{ "beets" : 130, "yams" : 200 }
$ replaceRoot 具有$ match 阶段
名为people的集合包含以下文档：
{ "_id" : 1, "name" : "Arlene", "age" : 34, "pets" : { "dogs" : 2, "cats" : 1 } }
{ "_id" : 2, "name" : "Sam", "age" : 41, "pets" : { "cats" : 1, "hamsters" : 3 } }
{ "_id" : 3, "name" : "Maria", "age" : 25 }
为了使用$replaceRoot阶段运行聚合操作以将pets字段提升到最高级别，您还需要包括$match阶段以过滤出不包含pets字段的所有文档。
db.people.aggregate( [
{
$match: { pets : { $exists: true } }
},
{
$replaceRoot: { newRoot: "$pets" }
}
] )
该操作返回以下结果：
{ "dogs" : 2, "cats" : 1 }
{ "cats" : 1, "hamsters" : 3 }
$ replaceRoot 和新创建的文档
您还可以在$replaceRoot阶段中创建新文档，并使用它们替换所有其他字段。
名为contacts的集合包含以下文档：
{ "_id" : 1, "first_name" : "Gary", "last_name" : "Sheffield", "city" : "New York" }
{ "_id" : 2, "first_name" : "Nancy", "last_name" : "Walker", "city" : "Anaheim" }
{ "_id" : 3, "first_name" : "Peter", "last_name" : "Sumner", "city" : "Toledo" }
以下操作从first_name和last_name字段中创建一个新文档。
db.contacts.aggregate( [
{
$replaceRoot: {
newRoot: {
full_name: {
$concat : [ "$first_name", " ", "$last_name" ]
}
}
}
}
] )
该操作返回以下结果：
{ "full_name" : "Gary Sheffield" }
{ "full_name" : "Nancy Walker" }
{ "full_name" : "Peter Sumner" }
$ replaceRoot 与数组元素
名为contacts的集合包含以下文档：
{ "_id" : 1, "name" : "Susan",
"phones" : [ { "cell" : "555-653-6527" },
{ "home" : "555-965-2454" } ] }
{ "_id" : 2, "name" : "Mark",
"phones" : [ { "cell" : "555-445-8767" },
{ "home" : "555-322-2774" } ] }
以下操作将使用键cell将嵌入的文档提升到顶层：
db.contacts.aggregate( [
{
$unwind: "$phones"
},
{
$match: { "phones.cell" : { $exists: true } }
},
{
$replaceRoot: { newRoot: "$phones"}
}
] )
该操作返回以下结果：
{ "cell" : "555-653-6527" }
{ "cell" : "555-445-8767" }