> ## 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.

> 精确计算数值数据序列在不同级别上的多个分位数，并同时考虑每个元素的权重。

# quantilesExactWeighted

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

Introduced in：v1.1.0

精确计算数值数据序列在不同级别上的多个[分位数](https://en.wikipedia.org/wiki/Quantile)，并同时考虑每个元素的权重。

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

**Syntax**

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

**参数**

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

**Arguments**

* `expr` — 对列值求值后得到数值数据类型、`Date`、`DateTime` 或 `DateTime64` 的表达式。[`(U)Int*`](/docs/zh/reference/data-types/int-uint) 或 [`Int128`](/docs/zh/reference/data-types/int-uint) 或 [`UInt128`](/docs/zh/reference/data-types/int-uint) 或 [`Int256`](/docs/zh/reference/data-types/int-uint) 或 [`UInt256`](/docs/zh/reference/data-types/int-uint) 或 [`Float*`](/docs/zh/reference/data-types/float) 或 [`Decimal*`](/docs/zh/reference/data-types/decimal) 或 [`Date`](/docs/zh/reference/data-types/date) 或 [`DateTime`](/docs/zh/reference/data-types/datetime) 或 [`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) 或 [`Array(Int128)`](/docs/zh/reference/data-types/array) 或 [`Array(UInt128)`](/docs/zh/reference/data-types/array) 或 [`Array(Int256)`](/docs/zh/reference/data-types/array) 或 [`Array(UInt256)`](/docs/zh/reference/data-types/array) 或 [`Array(Float*)`](/docs/zh/reference/data-types/array) 或 [`Array(Decimal*)`](/docs/zh/reference/data-types/array) 或 [`Array(Date)`](/docs/zh/reference/data-types/array) 或 [`Array(DateTime)`](/docs/zh/reference/data-types/array) 或 [`Array(DateTime64)`](/docs/zh/reference/data-types/array)

**示例**

**计算多个精确加权分位数**

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

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