AggregateCommand.push(value: any): Object

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

聚合操作符。在 group 阶段，返回一组中表达式指定列与对应的值，一起组成的数组。

参数

value: any

返回值

Object

API 说明

push 语法如下：

  1. db.command.aggregate.push({
  2.   <字段名1>: <指定字段1>,
  3.   <字段名2>: <指定字段2>,
  4.   ...
  5. })

示例代码

假设集合 students 的记录如下：

  1. { "group": "a", "name": "stu1", "score": 84 }
  2. { "group": "a", "name": "stu2", "score": 96 }
  3. { "group": "b", "name": "stu3", "score": 80 }
  4. { "group": "b", "name": "stu4", "score": 100 }

借助 push 操作，对不同分组( group )的所有记录，聚合所有数据并且将其放入一个新的字段中，进一步结构化和语义化数据。

  1. const $ = db.command.aggregate
  2. db
  3.   .collection('students')
  4.   .aggregate()
  5.   .group({
  6.     _id: '$group',
  7.     students: $.push({
  8.       name: '$name',
  9.       score: '$score'
  10.     })
  11.   })
  12.   .end()

输出结果如下：

  1. { "_id": "b", "students": [{ "name": "stu3", "score": 80 }, { "name": "stu4", "score": 100 }] }
  2. { "_id": "a", "students": [{ "name": "stu1", "score": 84 }, { "name": "stu2", "score": 96 }] }