percentile_approx 聚合函数

  • 项目

适用于：Databricks SQL check marked yes Databricks Runtime

返回组内 expr 的百分位近似值。 此函数是 approx_percentile 聚合函数的同义词。

语法

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

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

参数

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

返回

聚合函数返回在已排序的组（从最小到最大排序）中为最小值的表达式，因此最多 expr 值的 percentile 小于或等于该值。 如果 percentile 是数组 percentile_approx，则以指定的百分位返回 expr 的近似百分位数组。

accuracy 参数以内存成本控制近似精度。 准确度值越高，准确度越高，1.0/accuracy 是近似值的相对误差。

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

示例

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

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

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