MEDIAN¶

構文¶

集計関数

MEDIAN( <expr> )

ウィンドウ関数

MEDIAN( <expr> ) OVER ( [ PARTITION BY <expr2> ] )

引数¶

expr

The expression must evaluate to a numeric data type (INTEGER, FLOAT, DECIMAL, or equivalent).

戻り値¶

Returns a FLOAT or DECIMAL (fixed-point) number, depending upon the input.

使用上の注意¶

• 非NULL 値の数が1以上の奇数の場合、これは非NULL値の中央値（「中央」）を返します。

• 非NULL 値の数が偶数の場合、2つの中央値の平均に等しい値が返されます。たとえば、値が1、3、5、および20の場合、これは4（3と5の平均）を返します。

• すべての値が NULLの場合、これは NULLを返します。

• 非NULL 値の値の数が0の場合、これは NULLを返します。

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

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

  • OVER 句内の ORDER BY 句。

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

例¶

これは、関数の使用方法を示しています。

空のテーブルを作成します。

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

Get the MEDIAN value for column v. The function returns NULL because there are no rows.

SELECT MEDIAN(v)
  FROM aggr;

+------------+
| MEDIAN (V) |
|------------|
|       NULL |
+------------+

いくつかの行を挿入します。

INSERT INTO aggr VALUES (1, 10), (1, 20), (1, 21);
INSERT INTO aggr VALUES (2, 10), (2, 20), (2, 25), (2, 30);
INSERT INTO aggr VALUES (3, NULL);

Get the MEDIAN value for each group. Note that because the number of values in group k = 2 is an even number, the returned value for that group is the mid-point between the two middle numbers.

SELECT k, MEDIAN(v)
  FROM aggr
  GROUP BY k
  ORDER BY k;

+---+-----------+
| K | MEDIAN(V) |
|---+-----------|
| 1 |  20.00000 |
| 2 |  22.50000 |
| 3 |      NULL |
+---+-----------+