跳过至主要内容

quantileTiming

使用确定的精度计算分位数一个数值数据序列。

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

在查询中使用多个quantile*函数时,如果它们具有不同的级别,则不会组合内部状态(也就是说,查询的效率低于预期)。在这种情况下,请使用quantiles函数。

语法

quantileTiming(level)(expr)

别名:medianTiming

参数

  • level — 分位数级别。可选参数。0 到 1 之间的常量浮点数。建议在[0.01, 0.99]范围内使用level值。默认值:0.5。在level=0.5时,函数计算中位数.

  • expr表达式在列值上返回一个Float*类型数字。

    • 如果向函数传递负值,则行为未定义。
    • 如果值大于 30,000(页面加载时间超过 30 秒),则它被假定为 30,000。

准确度

如果计算是准确的

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

否则,计算结果将舍入到最接近的 16 毫秒倍数。

注意

对于计算页面加载时间分位数,此函数比quantile更有效和准确。

返回值

  • 指定级别的分位数。

类型:Float32

注意

如果没有值传递给函数(在使用quantileTimingIf时),则返回NaN。这样做是为了区分这些情况与导致零的情况。参见ORDER BY 子句关于对NaN值进行排序的说明。

示例

输入表

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

查询

SELECT quantileTiming(response_time) FROM t

结果

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

参见