$ 示例 （聚合阶段）

定义

$sample

从输入文档中随机选择指定数量的文档。

$sample 阶段语法：

{ $sample: { size: <positive integer N> } }

N 是随机选择的文档数量。 将 N 设置为大于或等于 1 的整数。

行为

如果以下所有条件都成立，则 $sample 将使用伪随机游标来选择 N 文档：

• $sample 是管道的第一个阶段。

• N 少于集合中文档总数的 5%。

  注意

  无法配置 $sample 用于确定何时扫描整个集合的阈值。阈值为 5%。如果大小超过集合中文档总数的 5%，$sample 将执行按生成的随机值排序的 top-k 排序。如果示例文档大于 100 MB，top-k 排序可能会溢出到磁盘。

• 该集合包含 100 多个文档。

如果前面有任何条件是错误的，$sample：

• 读取之前的聚合阶段或集合扫描输出的所有文档。

• 执行随机排序以选择 N 个文档。 随机排序受排序内存限制。

  注意

  视图是聚合管道的结果。当您在视图上使用 $sample 时，MongoDB 会将该阶段附加到视图聚合管道语法的末尾。因此，视图上的 $sample 阶段永远不是第一阶段，并且始终会导致集合扫描。

如果在分片集群中使用 $sample，则每个分片都会独立执行采样操作。mongos 对每个分片的采样操作的合并结果进行采样，并返回所请求的文档数。

示例

db.movies.aggregate(   [      { $sample: { size: 3 } },      { $project: { _id: 0, title: 1, year: 1, genres: 1 } }   ])

var pipeline = new EmptyPipelineDefinition<Movie>()    .Sample(5);

const pipeline = [{ $sample: { size: 5 } }];
const cursor = collection.aggregate(pipeline);return cursor;