approx_percentile 聚合函数

适用于:勾选“是” Databricks SQL 勾选“是” 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 返回 exprpercentile 处的近似百分位数组。 参数 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