quantilesDeterministic - ClickHouse Documentation

quantilesDeterministic

引入版本：v1.1.0 使用确定性水塘抽样，同时计算数值数据序列在不同级别上的多个近似分位数。此函数等同于 quantileDeterministic，但它支持在一次遍历中计算多个分位级别，因此比逐个调用各个分位函数更高效。语法

quantilesDeterministic(level1, level2, ...)(expr, determinator)

参数

level — 分位数的级别。一个或多个介于 0 到 1 之间的常量浮点数。建议将 level 值设在 [0.01, 0.99] 范围内。Float*

Arguments

expr — 基于列值计算的表达式，其结果为数值数据类型、Date 或 DateTime。(U)Int* 或 Int128 或 UInt128 或 Int256 或 UInt256 或 Float* 或 Date 或 DateTime
determinator — 在蓄水池采样算法中，其哈希值会替代随机数生成器使用的随机数，从而使采样结果具有确定性。UInt*

返回值 按指定级别返回的近似分位数组，顺序与级别的指定顺序一致。Array(Float64) 或 Array(Date) 或 Array(DateTime) 示例 计算多个确定性分位数

Query

SELECT quantilesDeterministic(0.25, 0.5, 0.75)(number, number) FROM numbers(10)

Response

┌─quantilesDeterministic(0.25, 0.5, 0.75)(number, number)─┐
│ [2.25,4.5,6.75]                                         │
└─────────────────────────────────────────────────────────┘

最后修改于 2026年7月23日