$ set（汇总）_MonogDB 中文网

MongoDB 中文手册

参考 > 参考 > 经营者 > 聚合管道阶段 > $ set（汇总）

在本页面

定义
行为
例子

定义¶

消歧

下一页涉及聚合阶段 $set，可从MongoDB 4.2开始使用。有关更新运算符$set，请参见$set。

$set¶

4.2版中的新功能。

将新字段添加到文档。$set输出包含输入文档中所有现有字段和新添加的字段的文档。

该$set阶段是的别名$addFields。

这两个阶段等效于一个$project阶段，该阶段明确指定输入文档中的所有现有字段并添加新字段。

$set 具有以下形式：

复制

{ $set: { <newField>: <expression>, ... } }

指定要添加的每个字段的名称，并将其值设置为聚合表达式。有关表达式的更多信息，请参见表达式。

重要

如果新字段的名称与现有字段名称（包括_id）相同$set，则使用指定表达式的值覆盖该字段的现有值。

行为¶

$set将新字段追加到现有文档。您可以$set在聚合操作中包括一个或多个阶段。

要将一个或多个字段添加到嵌入式文档（包括数组中的文档），请使用点符号。参见示例。

要将元素添加到现有的数组字段中$set，请使用$concatArrays。参见示例。

例子¶

使用两个`$set`阶段¶

scores使用以下内容创建一个样本集合：

复制

db.scores.insertMany([
   { _id: 1, student: "Maya", homework: [ 10, 5, 10 ], quiz: [ 10, 8 ], extraCredit: 0 },
   { _id: 2, student: "Ryan", homework: [ 5, 6, 5 ], quiz: [ 8, 8 ], extraCredit: 8 }
])

以下操作分两个$set阶段在输出文档中包括三个新字段：

复制

db.scores.aggregate( [
   {
     $set: {
        totalHomework: { $sum: "$homework" },
        totalQuiz: { $sum: "$quiz" }
     }
   },
   {
     $set: {
        totalScore: { $add: [ "$totalHomework", "$totalQuiz", "$extraCredit" ] } }
   }
] )

该操作返回以下文档：

复制

{
  "_id" : 1,
  "student" : "Maya",
  "homework" : [ 10, 5, 10 ],
  "quiz" : [ 10, 8 ],
  "extraCredit" : 0,
  "totalHomework" : 25,
  "totalQuiz" : 18,
  "totalScore" : 43
}
{
  "_id" : 2,
  "student" : "Ryan",
  "homework" : [ 5, 6, 5 ],
  "quiz" : [ 8, 8 ],
  "extraCredit" : 8,
  "totalHomework" : 16,
  "totalQuiz" : 16,
  "totalScore" : 40
}

添加字段嵌入文档中¶

使用点表示法将新字段添加到嵌入式文档中。

vehicles使用以下内容创建一个样本集合：

复制

db.vehicles.insertMany([
   { _id: 1, type: "car", specs: { doors: 4, wheels: 4 } },
   { _id: 2, type: "motorcycle", specs: { doors: 0, wheels: 2 } },
   { _id: 3, type: "jet ski" }
])

以下聚合操作将一个新字段添加fuel_type到嵌入式文档specs。

复制

db.vehicles.aggregate( [
   { $set: { "specs.fuel_type": "unleaded" } }
] )

该操作返回以下结果：

复制

{ _id: 1, type: "car", specs: { doors: 4, wheels: 4, fuel_type: "unleaded" } }
{ _id: 2, type: "motorcycle", specs: { doors: 0, wheels: 2, fuel_type: "unleaded" } }
{ _id: 3, type: "jet ski", specs: { fuel_type: "unleaded" } }

覆盖现有场¶

在$set操作中指定现有字段名称将导致替换原始字段。

创建一个调用animals以下示例的样本集合：

复制

db.animals.insertOne( { _id: 1, dogs: 10, cats: 15 } )

以下$set操作将覆盖该cats字段：

复制

db.animals.aggregate( [
  { $set: { "cats": 20 } }
] )

该操作返回以下文档：

复制

{ _id: 1, dogs: 10, cats: 20 }

可以将一个字段替换为另一个字段。在以下示例中，该item字段替代了该_id字段。

创建一个名为的样本集合，fruits其中包含以下文档：

复制

db.fruits.insertMany([
   { "_id" : 1, "item" : "tangerine", "type" : "citrus" },
   { "_id" : 2, "item" : "lemon", "type" : "citrus" },
   { "_id" : 3, "item" : "grapefruit", "type" : "citrus" }
])

以下聚集操作用于$set将_id每个文档的字段替换为字段的值item，并使用itemstring 替换字段"fruit"。

复制

db.fruits.aggregate( [
  { $set: { _id : "$item", item: "fruit" } }
] )

该操作返回以下内容：

复制

{ "_id" : "tangerine", "item" : "fruit", "type" : "citrus" }
{ "_id" : "lemon", "item" : "fruit", "type" : "citrus" }
{ "_id" : "grapefruit", "item" : "fruit", "type" : "citrus" }

向数组添加元素¶

scores使用以下内容创建一个样本集合：

复制

db.scores.insertMany([
   { _id: 1, student: "Maya", homework: [ 10, 5, 10 ], quiz: [ 10, 8 ], extraCredit: 0 },
   { _id: 2, student: "Ryan", homework: [ 5, 6, 5 ], quiz: [ 8, 8 ], extraCredit: 8 }
])

可以使用$set与一个$concatArrays 表达将元素添加到现有的阵列字段。例如，以下操作用于$set将一个homework字段替换为一个新数组，该数组的元素是当前 homework数组与另一个包含新score的数组连接在一起。[ 7 ]

复制

db.scores.aggregate([
   { $match: { _id: 1 } },
   { $set: { homework: { $concatArrays: [ "$homework", [ 7 ] ] } } }
])

该操作返回以下内容：

{ "_id" : 1, "student" : "Maya", "homework" : [ 10, 5, 10, 7 ], "quiz" : [ 10, 8 ], "extraCredit" : 0 }

MongoDB 中文手册

$ set（汇总）

定义¶

行为¶

例子¶

使用两个$set阶段¶

添加字段嵌入文档中¶

覆盖现有场¶

向数组添加元素¶

使用两个`$set`阶段¶