Aggregate.sample(size: number): Aggregate

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

聚合阶段。随机从文档中选取指定数量的记录。

参数

size: number

返回值

Aggregate

API 说明

sample 的形式如下：

  1. sample({
  2.     size: <正整数>
  3. })

请注意：size 是正整数，否则会出错。

示例

假设文档 users 有以下记录：

  1. { "name": "a" }
  2. { "name": "b" }

随机选取

如果现在进行抽奖活动，需要选出一名幸运用户。那么 sample 的调用方式如下：

  1. db.collection('users')
  2.   .aggregate()
  3.   .sample({
  4.     size: 1
  5.   })
  6.   .end()

返回了随机选中的一个用户对应的记录，结果如下：

  1. { "_id": "696529e4-7e82-4e7f-812e-5144714edff6", "name": "b" }