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

> 同时计算多个不同级别的近似分位数，并提供相对误差保证。

# quantilesDD

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

引入版本：v24.1.0

同时计算样本在不同级别上的多个近似[分位数](https://en.wikipedia.org/wiki/Quantile)，并提供相对误差保证。

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

**语法**

```sql theme={null}
quantilesDD(relative_accuracy, level1, level2, ...)(expr)
```

**参数**

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

**参数**

* `expr` — 基于列值计算的 expression，结果为数值 data type、`Date` 或 `DateTime`。[`(U)Int*`](/docs/zh/reference/data-types/int-uint) 或 [`Float*`](/docs/zh/reference/data-types/float) 或 [`Date`](/docs/zh/reference/data-types/date) 或 [`DateTime`](/docs/zh/reference/data-types/datetime)

**返回值**

按指定级别的顺序返回对应的近似分位数组。对于 `Date` 和 `DateTime` 输入，output format 与 input format 一致。[`Array(Float64)`](/docs/zh/reference/data-types/array) 或 [`Array(Date)`](/docs/zh/reference/data-types/array) 或 [`Array(DateTime)`](/docs/zh/reference/data-types/array)

**示例**

**使用 DDSketch 计算多个分位数**

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

```response title=Response theme={null}
┌─quantilesDD(0.01, 0.25, 0.5, 0.75)(number)────────────────┐
│ [1.9936617014173448,4.0148353330285875,5.989510371172621] │
└───────────────────────────────────────────────────────────┘
```
