PERCENTILE_DISC¶

構文¶

集計関数

PERCENTILE_DISC( <percentile> ) WITHIN GROUP (ORDER BY <order_by_expr> )

ウィンドウ関数

PERCENTILE_DISC( <percentile> )
  WITHIN GROUP (ORDER BY <order_by_expr> )
  OVER ( [ PARTITION BY <expr3> ] )

引数¶

percentile

検索する値のパーセンタイルです。パーセンタイルは、0.0～1.0の定数でなければなりません。例えば、90パーセンタイルで値を検索する場合は、0.9を指定します。

order_by_expr

値を並べ替える式（通常は列名）です。たとえば、数学の SAT スコアが90番目のパーセンタイルにある学生を検索する場合は、数学の SAT スコアを含む列を指定します。

これは、戻り値が選択される列でもあることに注意してください。たとえば、数学 SAT スコアで並べ替えると、結果は数学 SAT スコアの1つになります。1つの列で並べ替えて、別の列のパーセンタイル値を取得することはできません。

expr3

これは、行をパーティションにグループ化するために使用されるオプションの式です。

戻り値¶

指定されたパーセンタイルにある値を返します。

使用上の注意¶

• 関数の percentile 引数は定数でなければなりません。

• DISTINCT はこの関数ではサポートされていません。

• The function PERCENTILE_CONT interpolates between the two closest values, while the function PERCENTILE_DISC chooses the closest value rather than interpolating.

• この関数がウィンドウ関数として呼び出される場合、以下はサポートされていません。

  • OVER 句内の ORDER BY 句。

  • 明示的なウィンドウフレーム。

例¶

次の例は、さまざまなグループ内の25番目のパーセンタイル（0.25）の値を示しています。

値が含まれるテーブルを作成および生成します。

CREATE OR REPLACE TABLE aggr (k INT, v DECIMAL(10,2));

INSERT INTO aggr (k, v) VALUES
  (0,  0),
  (0, 10),
  (0, 20),
  (0, 30),
  (0, 40),
  (1, 10),
  (1, 20),
  (2, 10),
  (2, 20),
  (2, 25),
  (2, 30),
  (3, 60),
  (4, NULL);

クエリを実行し、出力を表示します。

SELECT k, PERCENTILE_DISC(0.25) WITHIN GROUP (ORDER BY v)
  FROM aggr
  GROUP BY k
  ORDER BY k;

+---+-------------------------------------------------+
| K | PERCENTILE_DISC(0.25) WITHIN GROUP (ORDER BY V) |
|---+-------------------------------------------------|
| 0 |                                           10.00 |
| 1 |                                           10.00 |
| 2 |                                           10.00 |
| 3 |                                           60.00 |
| 4 |                                            NULL |
+---+-------------------------------------------------+