> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> 使用线性插值，在不同级别同时计算数值数据序列的多个分位数，并将每个元素的权重纳入考虑。

# quantilesInterpolatedWeighted

<div id="quantilesInterpolatedWeighted">
  ## quantilesInterpolatedWeighted
</div>

引入版本：v23.1.0

使用线性插值，同时计算数值数据序列在不同级别上的多个[分位数](https://en.wikipedia.org/wiki/Quantile)，并将每个元素的权重纳入计算。

此函数等价于 [`quantileInterpolatedWeighted`](/docs/zh/reference/functions/aggregate-functions/quantileInterpolatedWeighted)，但支持在一次遍历中计算多个分位数级别，因此比逐个调用分位数函数更高效。

**语法**

```sql theme={null}
quantilesInterpolatedWeighted(level1, level2, ...)(expr, weight)
```

**参数**

* `level` — 分位数的级别。一个或多个介于 0 到 1 之间的常量浮点数。建议将 `level` 的值设在 `[0.01, 0.99]` 范围内。[`Float*`](/docs/zh/reference/data-types/float)

**参数**

* `expr` — 基于列值计算、结果为数值数据类型、`Date`、`DateTime` 或 `DateTime64` 的表达式。[`(U)Int*`](/docs/zh/reference/data-types/int-uint) or [`Int128`](/docs/zh/reference/data-types/int-uint) or [`UInt128`](/docs/zh/reference/data-types/int-uint) or [`Int256`](/docs/zh/reference/data-types/int-uint) or [`UInt256`](/docs/zh/reference/data-types/int-uint) or [`Float*`](/docs/zh/reference/data-types/float) or [`Decimal*`](/docs/zh/reference/data-types/decimal) or [`Date`](/docs/zh/reference/data-types/date) or [`DateTime`](/docs/zh/reference/data-types/datetime) or [`DateTime64`](/docs/zh/reference/data-types/datetime64)
* `weight` — 序列成员的权重列。权重表示某个值出现的次数。[`UInt*`](/docs/zh/reference/data-types/int-uint)

**返回值**

由指定级别的分位数组成的数组，顺序与指定级别的顺序相同。对于数值数据类型，输出格式与输入格式一致。[`Array((U)Int*)`](/docs/zh/reference/data-types/array) or [`Array(Int128)`](/docs/zh/reference/data-types/array) or [`Array(UInt128)`](/docs/zh/reference/data-types/array) or [`Array(Int256)`](/docs/zh/reference/data-types/array) or [`Array(UInt256)`](/docs/zh/reference/data-types/array) or [`Array(Float*)`](/docs/zh/reference/data-types/array) or [`Array(Decimal*)`](/docs/zh/reference/data-types/array) or [`Array(Date)`](/docs/zh/reference/data-types/array) or [`Array(DateTime)`](/docs/zh/reference/data-types/array) or [`Array(DateTime64)`](/docs/zh/reference/data-types/array)

**示例**

**计算多个经插值的加权分位数**

```sql title=Query theme={null}
SELECT quantilesInterpolatedWeighted(0.25, 0.5, 0.75)(number, 1) FROM numbers(10)
```

```response title=Response theme={null}
┌─quantilesInterpolatedWeighted(0.25, 0.5, 0.75)(number, 1)─┐
│ [2,4,7]                                                   │
└───────────────────────────────────────────────────────────┘
```