quantileInterpolatedWeighted

引入版本：v23.1

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

为了得到插值后的值，首先将传入的所有数值合并成一个数组，然后按照对应的权重进行排序。接着使用加权百分位数方法进行分位数插值：基于权重构建累积分布，然后使用权重和数值进行线性插值来计算分位数。

在同一个查询中使用多个具有不同分位水平的 quantile* 函数时，其内部状态不会被合并（也就是说，该查询的执行效率低于理论上的最优情况）。在这种情况下，请使用 quantiles 函数。

语法

quantileInterpolatedWeighted(level)(expr, weight)

别名：medianInterpolatedWeighted

参数

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

示例

计算插值加权分位数

CREATE TABLE t (
    n Int32,
    val Int32
) ENGINE = Memory;

INSERT INTO t VALUES (0, 3), (1, 2), (2, 1), (5, 4);

SELECT quantileInterpolatedWeighted(n, val) FROM t;

┌─quantileInterpolatedWeighted(n, val)─┐
│                                    1 │
└──────────────────────────────────────┘

另请参阅

quantileInterpolatedWeighted​

quantileInterpolatedWeighted