percentile_disc 集計関数

適用対象: Databricks SQL Databricks Runtime 11.3 LTS 以降

離散型分布モデルを使用して、指定された sortKey の percentile に対応する値を返します。

構文

percentile_disc ( 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 のグループ内の percentile に一致する sortKey 値を返します。

例

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

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

関連項目

• percentile_approx 集計関数
• approx_count_distinct 集計関数
• percentile 集計関数
• percentile_cont 集計関数
• ウィンドウ関数