ClickHouse/docs/zh/sql-reference/aggregate-functions/reference/quantile.md

toc_priority
200

quantile

计算数字序列的近似分位数。 此函数应用[水塘抽样][reservoir sampling] (https://en.wikipedia.org/wiki/Reservoir_sampling)，使用高达8192的水塘大小和随机数发生器采样。 结果是不确定的。要获得精确的分位数，使用 quantileExact 函数。 当在一个查询中使用多个不同层次的 quantile* 时，内部状态不会被组合（即查询的工作效率低于组合情况）。在这种情况下，使用 quantiles 函数。

语法

quantile(level)(expr)

别名: median。

参数

• level — 分位数层次。可选参数。从0到1的一个float类型的常量。 我们推荐 level 值的范围为 [0.01, 0.99]. 默认值：0.5。 当 level=0.5时，该函数计算 中位数。
• expr — — 求值表达式，类型为数值类型data types, Date 或 DateTime。

返回值

• 指定层次的分位数。

类型:

• Float64 用于数字数据类型输入。
• Date 如果输入值是 Date 类型。
• DateTime 如果输入值是 DateTime 类型。

示例

输入表:

┌─val─┐
│   1 │
│   1 │
│   2 │
│   3 │
└─────┘

查询:

SELECT quantile(val) FROM t

结果:

┌─quantile(val)─┐
│           1.5 │
└───────────────┘

参见

• 中位数
• 分位数