$ replaceRoot（聚合）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 聚合管道阶段 > $ replaceRoot（聚合）

在本页面

定义
行为
例子

定义¶

$replaceRoot¶

3.4版的新功能。

用指定的文档替换输入的文档。该操作将替换输入文档中的所有现有字段，包括该_id字段。您可以将现有的嵌入式文档升级到顶层，也可以创建一个新的文档进行升级（请参阅示例）。

注意

从4.2版开始，MongoDB添加了一个新的聚合管道阶段$replaceWith，该阶段是的别名 $replaceRoot。

该$replaceRoot阶段具有以下形式：

复制

{ $replaceRoot: { newRoot: <replacementDocument> } }

替换文档可以是解析为文档的任何有效表达式。如果<replacementDocument>不是文档，阶段会出错并失败。有关表达式的更多信息，请参见表达式。

行为¶

如果<replacementDocument>不是文档，则会 $replaceRoot出错并失败。

如果<replacementDocument>解析为丢失的文档（即该文档不存在），$replaceRoot则会出错并失败。例如，使用以下文档创建一个集合：

复制

db.collection.insertMany([
   { "_id": 1, "name" : { "first" : "John", "last" : "Backus" } },
   { "_id": 2, "name" : { "first" : "John", "last" : "McCarthy" } },
   { "_id": 3, "name": { "first" : "Grace", "last" : "Hopper" } },
   { "_id": 4, "firstname": "Ole-Johan", "lastname" : "Dahl" },
])

然后，以下$replaceRoot操作将失败，因为其中一个文档没有该name字段：

复制

db.collection.aggregate([
   { $replaceRoot: { newRoot: "$name" } }
])

为了避免该错误，您可以使用$mergeObjects将该name文档合并到某些默认文档中。例如：

复制

db.collection.aggregate([
   { $replaceRoot: { newRoot: { $mergeObjects: [ { _id: "$_id", first: "", last: "" }, "$name" ] } } }
])

或者，您可以name通过包含一个$match阶段来跳过缺少该字段的文档，以在将文档传递到该$replaceRoot 阶段之前检查文档字段的存在：

复制

db.collection.aggregate([
   { $match: { name : { $exists: true, $not: { $type: "array" }, $type: "object" } } },
   { $replaceRoot: { newRoot: "$name" } }
])

或者，您可以使用$ifNull表达式将其他一些文档指定为root。例如：

复制

db.collection.aggregate([
   { $replaceRoot: { newRoot: { $ifNull: [ "$name", { _id: "$_id", missingName: true} ] } } }
])

例子¶

`$replaceRoot`带有嵌入式文档字段¶

名为的集合people包含以下文档：

复制

{ "_id" : 1, "name" : "Arlene", "age" : 34, "pets" : { "dogs" : 2, "cats" : 1 } }
{ "_id" : 2, "name" : "Sam", "age" : 41, "pets" : { "cats" : 1, "fish" : 3 } }
{ "_id" : 3, "name" : "Maria", "age" : 25 }

以下操作使用该$replaceRoot阶段用$mergeObjects操作结果替换每个输入文档。该$mergeObjects 表达式将指定的默认文档与pets 文档合并。

复制

db.people.aggregate( [
   { $replaceRoot: { newRoot: { $mergeObjects:  [ { dogs: 0, cats: 0, birds: 0, fish: 0 }, "$pets" ] }} }
] )

该操作返回以下结果：

复制

{ "dogs" : 2, "cats" : 1, "birds" : 0, "fish" : 0 }
{ "dogs" : 0, "cats" : 1, "birds" : 0, "fish" : 3 }
{ "dogs" : 0, "cats" : 0, "birds" : 0, "fish" : 0 }

`$replaceRoot`文档嵌套在数组中¶

名为的集合students包含以下文档：

复制

db.students.insertMany([
   {
      "_id" : 1,
      "grades" : [
         { "test": 1, "grade" : 80, "mean" : 75, "std" : 6 },
         { "test": 2, "grade" : 85, "mean" : 90, "std" : 4 },
         { "test": 3, "grade" : 95, "mean" : 85, "std" : 6 }
      ]
   },
   {
      "_id" : 2,
      "grades" : [
         { "test": 1, "grade" : 90, "mean" : 75, "std" : 6 },
         { "test": 2, "grade" : 87, "mean" : 90, "std" : 3 },
         { "test": 3, "grade" : 91, "mean" : 85, "std" : 4 }
      ]
   }
])

以下操作将提升grade字段大于或等于90顶级的嵌入式文档：

复制

db.students.aggregate( [
   { $unwind: "$grades" },
   { $match: { "grades.grade" : { $gte: 90 } } },
   { $replaceRoot: { newRoot: "$grades" } }
] )

该操作返回以下结果：

复制

{ "test" : 3, "grade" : 95, "mean" : 85, "std" : 6 }
{ "test" : 1, "grade" : 90, "mean" : 75, "std" : 6 }
{ "test" : 3, "grade" : 91, "mean" : 85, "std" : 4 }

`$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`从中创建新文档`$$ROOT`和默认文档¶

创建一个contacts使用以下文档命名的集合：

复制

db.contacts.insert([
   { "_id" : 1, name: "Fred", email: "fred@example.net" },
   { "_id" : 2, name: "Frank N. Stine", cell: "012-345-9999" },
   { "_id" : 3, name: "Gren Dell", home: "987-654-3210", email: "beo@example.net" }
]);

以下操作使用$replaceRootwith $mergeObjects输出缺少字段的默认值的当前文档：

复制

db.contacts.aggregate([
   { $replaceRoot: { newRoot: { $mergeObjects: [ { _id: "", name: "", email: "", cell: "", home: "" }, "$$ROOT" ] } } }
])

聚合返回以下文档：

{ "_id" : 1, "name" : "Fred", "email" : "fred@example.net", "cell" : "", "home" : "" }
{ "_id" : 2, "name" : "Frank N. Stine", "email" : "", "cell" : "012-345-9999", "home" : "" }
{ "_id" : 3, "name" : "Gren Dell", "email" : "beo@example.net", "cell" : "", "home" : "987-654-3210" }

MongoDB 中文手册

$ replaceRoot（聚合）

定义¶

行为¶

例子¶

$replaceRoot带有嵌入式文档字段¶

$replaceRoot文档嵌套在数组中¶

$replaceRoot带有一个新创建的文档¶

$replaceRoot从中创建新文档$$ROOT和默认文档¶

`$replaceRoot`带有嵌入式文档字段¶

`$replaceRoot`文档嵌套在数组中¶

`$replaceRoot`带有一个新创建的文档¶

`$replaceRoot`从中创建新文档`$$ROOT`和默认文档¶