> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> 各要素の重みを考慮し、線形補間を用いて数値データ列の分位点を計算します。

# quantileInterpolatedWeighted

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

導入バージョン: v23.1.0

各要素の重みを考慮し、線形補間を用いて数値データ列の[分位点](https://en.wikipedia.org/wiki/Quantile)を計算します。

補間値を求めるには、渡されたすべての値を配列にまとめ、対応する重みに基づいてソートします。
その後、重みに基づく累積分布を構築し、[weighted percentile method](https://en.wikipedia.org/wiki/Percentile#The_weighted_percentile_method) を用いて分位点補間を行います。さらに、重みと値を使った線形補間によって分位点を計算します。

1 つのクエリ内で、異なるレベルを持つ複数の `quantile*` 関数を使用する場合、内部状態は結合されません (つまり、クエリの実行効率が本来より低くなります) 。
この場合は、[`quantiles`](/ja/reference/functions/aggregate-functions/quantiles#quantiles) 関数を使用してください。

**構文**

```sql theme={null}
quantileInterpolatedWeighted(level)(expr, weight)
```

**別名**: `medianInterpolatedWeighted`

**パラメータ**

* `level` — 任意。分位点のレベルです。0 から 1 までの定数浮動小数点数。`level` には `[0.01, 0.99]` の範囲の値を使用することを推奨します。デフォルト値: 0.5。`level=0.5` の場合、この関数は中央値を計算します。[`Float*`](/ja/reference/data-types/float)

**引数**

* `expr` — カラム値に対する式。結果は数値型、Date、または DateTime です。[`(U)Int*`](/ja/reference/data-types/int-uint) または [`Float*`](/ja/reference/data-types/float) または [`Decimal*`](/ja/reference/data-types/decimal) または [`Date`](/ja/reference/data-types/date) または [`DateTime`](/ja/reference/data-types/datetime)
* `weight` — シーケンス要素の重みを表すカラム。重みは値の出現回数です。[`UInt*`](/ja/reference/data-types/int-uint)

**戻り値**

指定したレベルの分位点。[`Float64`](/ja/reference/data-types/float) または [`Date`](/ja/reference/data-types/date) または [`DateTime`](/ja/reference/data-types/datetime)

**例**

**補間付きの重み付き分位点を計算する**

```sql title=Query theme={null}
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;
```

```response title=Response theme={null}
┌─quantileInterpolatedWeighted(n, val)─┐
│                                    1 │
└──────────────────────────────────────┘
```

**関連項目**

* [median](/ja/reference/functions/aggregate-functions/median)
* [quantiles](/ja/reference/functions/aggregate-functions/quantiles)