quantileExactWeightedInterpolated

新增于：v24.10

使用线性插值计算数值数据序列的分位数，并考虑每个元素的权重。

为了获得插值结果，首先将所有传入的值合并为一个数组，然后根据它们对应的权重进行排序。随后使用加权百分位方法进行分位数插值：基于权重构建累积分布，然后利用权重和值进行线性插值来计算分位数。

在查询中使用多个带有不同级别的 quantile* 函数时，其内部状态不会被合并（也就是说，该查询的执行效率低于其本可以达到的水平）。在这种情况下，请使用 quantiles 函数。

我们强烈建议使用 quantileExactWeightedInterpolated 而不是 quantileInterpolatedWeighted，因为 quantileExactWeightedInterpolated 比 quantileInterpolatedWeighted 更精确。更多细节请参见下面的示例。

语法

quantileExactWeightedInterpolated(level)(expr, weight)

别名：medianExactWeightedInterpolated

参数

level — 可选。分位数的级别。取值为 0 到 1 之间的常量浮点数。推荐在 [0.01, 0.99] 范围内使用 level 值。默认值：0.5。当 level=0.5 时，该函数计算中位数。Float*

参数

expr — 对列值进行运算的表达式，结果为数值数据类型、Date 或 DateTime。(U)Int* 或 Float* 或 Decimal* 或 Date 或 DateTime
weight — 包含序列成员权重的列。权重是表示某个值出现次数的数字。UInt*

返回值

指定级别的分位数。Float64 或 Date 或 DateTime

示例

计算精确加权插值分位数

SELECT quantileExactWeightedInterpolated(n, val) FROM t;

┌─quantileExactWeightedInterpolated(n, val)─┐
│                                       1.5 │
└───────────────────────────────────────────┘

优先使用 quantileExactWeightedInterpolated 而不是 quantileInterpolatedWeighted

SELECT
    quantileExactWeightedInterpolated(0.99)(number, 1),
    quantile(0.99)(number),
    quantileInterpolatedWeighted(0.99)(number, 1)
FROM numbers(9)

┌─quantileExactWeightedInterpolated(0.99)(number, 1)─┬─quantile(0.99)(number)─┬─quantileInterpolatedWeighted(0.99)(number, 1)─┐
│                                               7.92 │                   7.92 │                                             8 │
└────────────────────────────────────────────────────┴────────────────────────┴───────────────────────────────────────────────┘

另请参见

quantileExactWeightedInterpolated​

quantileExactWeightedInterpolated