quantile

数値データ列の近似分位数を計算します。

この関数は、最大8192のリザーバーサイズを持つリザーバーサンプリングとサンプリング用の乱数生成器を適用します。結果は非決定的です。正確な分位数を取得するには、quantileExact関数を使用してください。

クエリで異なるレベルの複数のquantile*関数を使用する場合、内部状態は結合されません（つまり、クエリは本来可能な効率で動作しません）。この場合は、quantiles関数を使用してください。

空の数値列の場合、quantileはNaNを返しますが、quantile*のバリエーションはNaNまたは列型のデフォルト値を返します（バリエーションによります）。

構文

quantile(level)(expr)

別名: median.

引数

• level — 分位数のレベル。オプションのパラメータ。0から1までの定数の浮動小数点数。level値として[0.01, 0.99]の範囲を使用することをお勧めします。デフォルト値: 0.5。level=0.5の場合、関数は中央値を計算します。
• expr — 数値型、DateまたはDateTimeの結果となるカラム値への式。

返される値

• 指定されたレベルの近似分位数。

型:

• 数値データ型入力の場合はFloat64。
• 入力値がDate型の場合はDate。
• 入力値がDateTime型の場合はDateTime。

例

入力テーブル:

┌─val─┐
│   1 │
│   1 │
│   2 │
│   3 │
└─────┘

クエリ:

SELECT quantile(val) FROM t

結果:

┌─quantile(val)─┐
│           1.5 │
└───────────────┘

参照

• median
• quantiles