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_namelast_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": "张牧之" }