跳到主要内容
跳到主要内容

quantileTimingWeighted

根据每个序列成员的权重,计算具有确定精度的 分位数 的数值数据序列。

结果是确定的(不依赖于查询处理顺序)。该函数经过优化,适合处理描述分布的序列,例如加载网页的时间或后端响应时间。

当在查询中使用多个不同级别的 quantile* 函数时,内部状态不会合并(即,查询的效率比它可以的效率低)。在这种情况下,使用 quantiles 函数。

语法

别名:medianTimingWeighted

参数

  • level — 分位数级别。可选参数。常量浮点数,范围从 0 到 1。我们建议将 level 值设定在 [0.01, 0.99] 范围内。默认值:0.5。在 level=0.5 时,函数计算 中位数

  • expr — 针对列值的 表达式,返回一个 Float*-类型的数字。

    • 如果传递给函数的是负值,则行为未定义。
    • 如果值超过 30,000(页面加载时间超过 30 秒),则假定它为 30,000。
  • weight — 含有序列元素权重的列。权重是值出现的次数。

准确性

计算是准确的,如果:

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

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

备注

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

返回值

  • 指定级别的分位数。

类型:Float32

备注

如果未向函数传递任何值(在使用 quantileTimingIf 时),返回 NaN。这样做的目的是将这些情况与结果为零的情况区分开来。有关排序 NaN 值的注意事项,请参见 ORDER BY 子句

示例

输入表:

查询:

结果:

quantilesTimingWeighted

quantileTimingWeighted 相同,但接受多个带有分位数级别的参数,并返回一个填充有多个分位数值的数组。

示例

输入表:

查询:

结果:

另见