approx_percentile 聚合函数

  • 项目

适用于：check marked yes Databricks SQL check marked yes Databricks Runtime

返回组内 expr 的百分位近似值。

语法

approx_percentile ( [ALL | DISTINCT] expr, percentile [, accuracy] ) [ FILTER ( WHERE cond ) ]

还可以使用 OVER 子句将此函数作为窗口函数调用。

参数

  • expr：数值表达式。
  • percentile：介于 0 和 1 之间的数值，或每个数值都介于 0 和 1 之间的数值文本数组。
  • accuracy：大于 0 的 INTEGER 文本。 如果省略精度，则将其设置为 10000。
  • cond：一个可选的布尔表达式，可筛选用于聚合的行。

返回

聚合函数返回在已排序的组（从最小到最大排序）中为最小值的表达式，因此最多 expr 值的 percentile 小于或等于该值。

如果 percentile 是一个数组，则 approx_percentile 返回 expr 在 percentile 处的近似百分位数组。 参数 accuracy 以内存为代价控制近似精度。 精度值越高，精度越好，1.0/accuracy 是近似值的相对误差。 此函数是 percentile_approx 聚合函数的同义词。

如果指定了 DISTINCT，则该函数仅对 expr 值的唯一集合进行操作。

示例

> SELECT approx_percentile(col, array(0.5, 0.4, 0.1), 100) FROM VALUES (0), (1), (2), (10) AS tab(col);
 [1,1,0]

> SELECT approx_percentile(col, 0.5, 100) FROM VALUES (0), (6), (6), (7), (9), (10) AS tab(col);
 6

> SELECT approx_percentile(DISTINCT col, 0.5, 100) FROM VALUES (0), (6), (6), (7), (9), (10) AS tab(col);
 7