quantileTiming

首次引入版本：v1.1.0 按指定精度计算数值数据序列的分位数。结果是确定性的 (不依赖于查询处理顺序) 。该函数针对描述分布的数据序列进行了优化，例如网页加载时间或后端响应时间。如果在同一查询中使用多个 level 不同的 quantile* 函数，它们的内部状态不会合并 (也就是说，查询的执行效率会低于可达到的水平) 。在这种情况下，请使用 quantiles 函数。精度在以下情况下，计算结果是精确的：

值的总数不超过 5670。
值的总数超过 5670，但页面加载时间小于 1024ms。

否则，计算结果会舍入为最接近的 16 ms 倍数。

对于计算页面加载时间的分位数，该函数比 quantile 更高效且更准确。

如果没有向函数传入任何值 (使用 quantileTimingIf 时) ，则返回 NaN。这样做是为了将这些情况与结果为零的情况区分开来。有关 NaN 值排序的说明，请参见 ORDER BY 子句。

语法

quantileTiming(level)(expr)

别名: medianTiming 参数

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

参数列表

expr — 基于列值计算并返回 Float* 类型数值的表达式。如果向函数传入负值，则其行为未定义。如果值大于 30,000 (页面加载时间超过 30 秒) ，则按 30,000 处理。Float*

返回值 指定水平的分位数。如果没有向函数传入任何值 (使用 quantileTimingIf 时) ，则返回 NaN。这样做是为了将这类情况与结果为零的情况区分开来。Float32 示例 计算时间分位数

Query

CREATE TABLE t (response_time UInt32) ENGINE = Memory;
INSERT INTO t VALUES (72), (112), (126), (145), (104), (242), (313), (168), (108);

SELECT quantileTiming(response_time) FROM t;

Response

┌─quantileTiming(response_time)─┐
│                           126 │
└───────────────────────────────┘

另请参见

​quantileTiming

quantileTiming