quantileTiming

以指定精度计算数值数据序列的分位数。

结果是确定性的（不依赖于查询的处理顺序）。该函数针对描述分布的序列进行了优化，例如网页加载时间或后端响应时间。

在一个查询中使用多个不同 level 的 quantile* 函数时，其内部状态不会被合并（也就是说，该查询的执行效率会低于其可能达到的最优效率）。在这种情况下，请使用 quantiles 函数。

语法

quantileTiming(level)(expr)

别名：medianTiming。

参数

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

• expr — 对列值进行的表达式，返回一个 Float* 类型的数字。

  • 如果向函数传入负值，其行为未定义。
  • 如果值大于 30,000（页面加载时间超过 30 秒），则会被视为 30,000。

精度

在以下情况下，计算是精确的：

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

否则，计算结果将被舍入到最接近的 16 ms 的倍数。

注意

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

返回值

• 指定水平的分位数。

类型：Float32。

注意

如果没有向函数传入任何值（在使用 quantileTimingIf 时），则会返回 NaN。这样做的目的是将这些情况与结果为零的情况区分开来。关于对 NaN 值进行排序的说明，请参阅 ORDER BY 子句。

示例

输入表：

┌─response_time─┐
│            72 │
│           112 │
│           126 │
│           145 │
│           104 │
│           242 │
│           313 │
│           168 │
│           108 │
└───────────────┘

查询：

SELECT quantileTiming(response_time) FROM t

结果：

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

另请参阅

• median
• quantiles