quantileDeterministic

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

この関数は、最大 8192 のリザーバサイズを持つリザーバサンプリングと決定論的なサンプリングアルゴリズムを適用します。結果は決定的になります。正確な分位点を取得するには、quantileExact 関数を使用してください。

1 つのクエリ内で複数の quantile* 関数を異なるレベルで使用する場合、内部状態はマージされません（つまり、そのクエリは本来可能なほど効率的には実行されません）。このような場合は、quantiles 関数を使用してください。

構文

quantileDeterministic(level)(expr, determinator)

Alias: medianDeterministic.

引数

• level — 分位数のレベル。省略可能なパラメータ。0 から 1 の範囲の定数の浮動小数点数です。level の値としては [0.01, 0.99] の範囲を使用することを推奨します。デフォルト値: 0.5。level=0.5 の場合、この関数は中央値を計算します。
• expr — 数値型のデータ型、Date または DateTime を結果とする、カラム値に対する式。
• determinator — サンプリング結果を決定的にするために、リザーバサンプリングアルゴリズムで乱数生成器の代わりに、そのハッシュが使用される数値。determinator には、ユーザー ID やイベント ID など、任意の決定的な正の数値を使用できます。同じ determinator の値があまりに頻繁に出現すると、この関数は正しく動作しません。

戻り値

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

型:

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

例

入力テーブル:

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

クエリ:

SELECT quantileDeterministic(val, 1) FROM t

結果：

┌─quantileDeterministic(val, 1)─┐
│                           1.5 │
└───────────────────────────────┘

関連項目

• median
• quantiles