> ## 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/ja/reference/functions/aggregate-functions/quantileddsketch) と同等ですが、1回の処理で複数の分位点レベルを計算できるため、個別に分位点関数を呼び出すより効率的です。

**構文**

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

**パラメータ**

* `relative_accuracy` — 分位点の相対精度。設定可能な値は 0 から 1 の範囲です。推奨値は 0.001 以上です。[`Float*`](/docs/ja/reference/data-types/float)
* `level` — 分位点のレベル。0 から 1 までの定数の浮動小数点数を 1 つ以上指定します。`level` の値は `[0.01, 0.99]` の範囲で使用することを推奨します。[`Float*`](/docs/ja/reference/data-types/float)

**引数**

* `expr` — カラムの値に対する式。評価結果は数値データ型、`Date`、または `DateTime` である必要があります。[`(U)Int*`](/docs/ja/reference/data-types/int-uint) または [`Float*`](/docs/ja/reference/data-types/float) または [`Date`](/docs/ja/reference/data-types/date) または [`DateTime`](/docs/ja/reference/data-types/datetime)

**戻り値**

指定したレベルの近似分位点の Array を、指定したレベルと同じ順序で返します。入力が `Date` および `DateTime` の場合、出力フォーマットは入力フォーマットと一致します。[`Array(Float64)`](/docs/ja/reference/data-types/array) または [`Array(Date)`](/docs/ja/reference/data-types/array) または [`Array(DateTime)`](/docs/ja/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] │
└───────────────────────────────────────────────────────────┘
```
