Aggregate.replaceRoot(object: Object): Aggregate

支持端：小程序 2.7.4 起, 云函数 0.8.1 起

聚合阶段。指定一个已有字段作为输出的根节点，也可以指定一个计算出的新字段作为根节点。

参数

object: Object

返回值

Aggregate

API 说明

replaceRoot 使用形式如下：

  1. replaceRoot({
  2.     newRoot: <表达式>
  3. })

表达式格式如下：

格式说明
<字段名>指定一个已有字段作为输出的根节点（如果字段不存在则报错）
<对象>计算一个新字段，并且把这个新字段作为根节点

示例

使用已有字段作为根节点

假设我们有一个 schools 集合，内容如下：

  1. {
  2.   "_id": 1,
  3.   "name": "SFLS",
  4.   "teachers": {
  5.     "chinese": 22,
  6.     "math": 18,
  7.     "english": 21,
  8.     "other": 123
  9.   }
  10. }

下面的代码使用 replaceRoot，把 teachers 字段作为根节点输出：

  1. db.collection('schools')
  2.   .aggregate()
  3.   .replaceRoot({
  4.     newRoot: '$teachers'
  5.   })
  6.   .end()

输出如下：

  1. {
  2.   "chinese": 22,
  3.   "math": 18,
  4.   "english": 21,
  5.   "other": 123
  6. }

使用计算出的新字段作为根节点

假设我们有一个 roles 集合，内容如下：

  1. { "_id": 1, "first_name": "四郎", "last_name": "黄" }
  2. { "_id": 2, "first_name": "邦德", "last_name": "马" }
  3. { "_id": 3, "first_name": "牧之", "last_name": "张" }

下面的代码使用 replaceRoot，把 first_name 和 last_name 拼在一起：

  1. const { concat } = db.command.aggregate
  2. db.collection('roles')
  3.   .aggregate()
  4.   .replaceRoot({
  5.     newRoot: {
  6.       full_name: concat(['$last_name', '$first_name'])
  7.     }
  8.   })
  9.   .end()

输出如下：

  1. { "full_name": "黄四郎" }
  2. { "full_name": "马邦德" }
  3. { "full_name": "张牧之" }