Docs 菜单
Docs 主页
/
MongoDB Manual
/
聚合操作
/
参考
/
阶段(Stages)

$set（聚合）

在此页面上

  • 定义
  • 兼容性
  • 语法
  • 行为
  • 示例

定义

注意

消歧

以下页面是指聚合阶段 $set。关于更新操作符 $set，请参阅 $set。

$set

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

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

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

兼容性

可以使用 $set 查找托管在以下环境中的部署：

  • MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

语法

$set 采用以下形式：

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

指定待添加的每个字段的名称，并将其值设置为聚合表达式或空对象。有关表达式的更多信息，请参阅表达式操作符。

重要

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

行为

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

  • $set 接受对象的嵌入，您可以将值设置为聚合表达式或空对象。例如，接受以下嵌套对象：

    {$set: { a: { b: { } } } }

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

  • 要使用 $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 字段的值，并将 item 字段替换为字符串 "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 数组与另一个数组的拼接，该数组包含新分数 [ 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 } ]

使用现有字段创建新字段

创建一个包含以下内容的示例 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 }
] )

以下聚合操作向每个包含 quiz 数组平均值的文档添加一个新字段 quizAverage。

db.scores.aggregate( [
   {
      $set: {
         quizAverage: { $avg: "$quiz" }
      }
   }
] )

该操作将返回以下文档：

[
   {
      _id: 1,
      student: 'Maya',
      homework: [ 10, 5, 10 ],
      quiz: [ 10, 8 ],
      extraCredit: 0,
      quizAverage: 9
   },
   {
      _id: 2,
      student: 'Ryan',
      homework: [ 5, 6, 5 ],
      quiz: [ 8, 8 ],
      extraCredit: 8,
      quizAverage: 8
   }
]

后退

$searchMeta

来年

$setWindowFields