定义
$percentile7.0版本新增。
返回与指定的各百分位数一一对应的标量值数组。
可在以下阶段使用:
注意
消歧
本页介绍了
$percentile用作 累加器 时的情况。累加器返回跨一组输入文档的聚合值。您还可以在这些其他上下文中使用
$percentile:$percentile (expression), 用于计算输入值数组中的百分位数值。$percentile (window function),用于在$setWindowFields阶段返回特定窗口中文档的百分位数值数组。
语法
{ $percentile: { input: <expression>, p: [ <expression1>, <expression2>, ... ], method: <string> }}选项
$percentile 采用以下字段:
字段 | 类型 | 必要性 | 说明 |
|---|---|---|---|
| 表达式(expression) | 必需 |
|
| 表达式(expression) | 必需 |
|
| 字符串 | 必需 | MongoDB 用于计算百分位数的方法。该方法必须是 |
行为
当作为累加器使用时,$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 评分。