quantileTDigest

引入版本：v1.1.0

使用 t-digest 算法计算数值数据序列的近似分位数。

内存消耗为 log(n)，其中 n 为值的数量。结果取决于查询的执行顺序，因此是非确定性的。

该函数的性能低于 quantile 和 quantileTiming。但从状态大小与精度的比率来看，该函数明显优于 quantile。

当在同一个查询中使用多个具有不同级别的 quantile* 函数时，内部状态不会合并 (也就是说，查询的执行效率会低于原本可达到的水平) 。这种情况下，请使用 quantiles 函数。

语法

quantileTDigest(level)(expr)

别名: medianTDigest

参数

• level — 可选。分位数级别。取值为 0 到 1 之间的常量浮点数。建议将 level 设为 [0.01, 0.99] 范围内的值。默认值：0.5。当 level=0.5 时，该函数计算中位数。Float*

参数

• expr — 基于列值的表达式，结果为数值数据类型、Date 或 DateTime。(U)Int* 或 Float* 或 Date 或 DateTime

返回值

指定级别的近似分位数。对于 Date 和 DateTime 输入，输出格式与输入格式一致。Float32 或 Date 或 DateTime

示例

使用 t-digest 计算分位数

SELECT quantileTDigest(number) FROM numbers(10);

┌─quantileTDigest(number)─┐
│                       4 │
└─────────────────────────┘

另见

• median
• quantiles