メインコンテンツまでスキップ
メインコンテンツまでスキップ

quantile

数値データ系列の近似した quantile を計算します。

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

クエリ内で異なるレベルの複数の quantile* 関数を使用する場合、内部状態は統合されません(つまり、クエリは効率的に動作しません)。この場合は、quantiles 関数を使用してください。

数値系列が空の場合、quantile は NaN を返しますが、その quantile* バリアントは、バリアントに応じてシーケンスタイプのデフォルト値または NaN を返します。

構文

quantile(level)(expr)

エイリアス: median.

引数

  • level — クオンタイルのレベル。オプションのパラメータ。0 から 1 の間の定数浮動小数点数です。level の値は、[0.01, 0.99] の範囲内を推奨します。デフォルト値: 0.5。level=0.5 で、この関数は median を計算します。
  • expr — 数値 データ型Date または DateTime の結果となるカラム値の式。

返される値

  • 指定されたレベルの近似クオンタイル。

タイプ:

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

入力テーブル:

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

クエリ:

SELECT quantile(val) FROM t

結果:

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

関連項目