对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

$百分位数(累加器运算符)

$percentile

7.0版本新增。

返回与指定的各百分位数一一对应的标量值数组。

可在以下阶段使用:

注意

消歧

本页介绍了 $percentile 用作 累加器 时的情况。累加器返回跨一组输入文档的聚合值。

您还可以在这些其他上下文中使用 $percentile:

{ $percentile: { input: <expression>, p: [ <expression1>, <expression2>, ... ], method: <string> }}

$percentile 采用以下字段:

字段
类型
必要性
说明

input

表达式(expression)

必需

$percentile 计算此数据的百分位数值。input 必须是计算结果为数字类型的表达式。如果表达式未评估为数值类型,$percentile 计算将忽略该值。

p

表达式(expression)

必需

$percentile 计算 p 中每个元素的百分位数。这些元素指定要计算的分位数,并且必须是在 0.0 到 1.0(包含在内)范围内的数值。

$percentile 按照与 p 中元素相同的顺序返回结果。

method

字符串

必需

MongoDB 用于计算百分位数的方法。该方法必须是 'approximate'。

当作为累加器使用时,$percentile:

  • 计算每组的一组百分位数,对组中的所有文档进行聚合。

  • 使用 t-digest 算法计算近似百分位数。为了使用有限大小的数据结构来计算百分位数,必须进行近似处理。

作为累加器使用时,$percentile 始终使用近似算法。由于 t-digest 近似算法中的伪随机性,在同一数据集上计算出的百分位数值在每次运行时可能会有所不同。此外,$percentile 可能会返回与真实的统计百分位数略有不同的值。

本页上的示例使用来自 sample_mflix 数据集的数据。有关如何将此数据集加载到您的自管理 MongoDB 部署中的详细信息,请参阅 加载示例数据集。如果您对示例数据库进行了任何修改,您可能需要删除并重新创建数据库,才能运行此页面上的示例。

以下示例使用 $percentile 累加器计算在 Action 和 Drama 类型中的电影的 50 和 90 百分位数 IMDB 评级:

db.movies.aggregate( [ { $unwind: "$genres" }, { $match: { genres: { $in: [ "Action", "Drama" ] }, "imdb.rating": { $exists: true } } }, { $group: { _id: "$genres", ratingPercentiles: { $percentile: { input: "$imdb.rating", p: [ 0.5, 0.9 ], method: "approximate" } } } }, { $sort: { _id: 1 } }] )

前面的管道:

  • 使用 $unwind 在 genres 数组中针对每个流派创建单独的文档。

  • 使用 $match 过滤器分类为 Action 或 Drama 并具有 IMDB 评分字段的电影。

  • 按类别分组电影。

  • 使用 $percentile 计算每个类型的 50百分位数和 90百分位数 IMDB 评级,并且具有 p: [0.5, 0.9]。

  • 使用 $sort 按类型名称对输出进行排序。

输出 ratingPercentiles 数组包含两个值:每个类别的 50 百分位数和 90 百分位数 IMDB 评分。

给本页内容打分