percentile_cont 集計関数

  • [アーティクル]

適用対象: check marked yes Databricks SQL 「はい」のチェック マーク Databricks Runtime 10.4 LTS 以降

連続配布モデルを使用して、指定された sortKey の percentile に対応する値を返します。

構文

percentile_cont ( percentile )
       WITHIN GROUP (ORDER BY sortKey [ASC | DESC] )

この関数は、OVER 句を使用して ウィンドウ 関数として呼び出すこともできます。

引数

  • percentile: 0 と 1 の間の数値リテラル、または数値リテラルのリテラル配列 (それぞれ 0 と 1 の間)。
  • sortKey: パーセンタイルを計算する数値式。
  • ASC または DESC: 昇順と降順のどちらを使用してパーセンタイルを計算するかを、必要に応じて指定します。 既定では、 ASCです。

戻り値

percentile が数値の場合は DOUBLE。percentile が ARRAY の場合は DOUBLE の ARRAY。

この集計関数は、sortKeys のグループ内にある補間されたパーセンタイルを返します。

例

-- Return the median, 40%-ile and 10%-ile.
> SELECT percentile_cont(array(0.5, 0.4, 0.1)) WITHIN GROUP (ORDER BY col)
    FROM VALUES (0), (1), (2), (10) AS tab(col);
 [1.5, 1.2000000000000002, 0.30000000000000004]

-- Return the interpolated median.
> SELECT percentile_cont(0.50) WITHIN GROUP (ORDER BY col)
    FROM VALUES (0), (6), (6), (7), (9), (10) AS tab(col);
 6.5