メインコンテンツまでスキップ
に最終更新

PERCENTILE_ARRAY

説明​

PERCENTILE_ARRAY 関数は複数の正確なパーセンタイル値を一度に計算します。主に小規模なデータセットに適しています。

主な特徴:

  1. 正確な計算: 近似値ではなく正確なパーセンタイル値を返します。
  2. 一括処理: 一回の操作で複数のパーセンタイルを計算できます。
  3. 適用範囲: 小規模なデータセットの処理に最も適しています。

構文​

PERCENTILE_ARRAY(<col>, <array_p>)

パラメータ​

パラメータ説明
<col>正確なパーセンタイルを計算する列。Double、Float、LargeInt、BigInt、Int、SmallInt、TinyInt 型をサポートします。
<array_p>パーセンタイルの配列。各要素は Array 型の定数で、値は [0.0, 1.0] の範囲にある必要があります。例: [0.5, 0.95, 0.99]。

戻り値​

計算したパーセンタイル値を含む DOUBLE 型の配列を返します。 グループ内に有効なデータがない場合は空配列を返します。

使用例​

-- setup
CREATE TABLE sales_data (
    id INT,
    amount DECIMAL(10, 2)
) DUPLICATE KEY(`id`)
DISTRIBUTED BY HASH(`id`) BUCKETS AUTO
PROPERTIES (
    "replication_allocation" = "tag.location.default: 1"
);
INSERT INTO sales_data VALUES
(1, 10.5),
(2, 15.2),
(3, 20.1),
(4, 25.8),
(5, 30.3),
(6, 35.7),
(7, 40.2),
(8, 45.9),
(9, 50.4),
(10, 100.6);
SELECT percentile_array(amount, [0.25, 0.5, 0.75, 0.9]) as percentiles
FROM sales_data;

複数のパーセンタイルを計算します。

+-----------------------------------------------------+
| percentiles                                         |
+-----------------------------------------------------+
| [21.525000000000002, 33, 44.475, 55.41999999999998] |
+-----------------------------------------------------+
SELECT percentile_array(if(amount>90, amount, NULL), [0.5, 0.99]) FROM sales_data;

NULL 以外のデータのみを計算します。

+------------------------------------------------------------+
| percentile_array(if(amount>90, amount, NULL), [0.5, 0.99]) |
+------------------------------------------------------------+
| [100.6, 100.6]                                             |
+------------------------------------------------------------+
SELECT percentile_array(NULL, [0.5, 0.99]) FROM sales_data;

すべての入力データが NULL の場合は空配列を返します。

+-------------------------------------+
| percentile_array(NULL, [0.5, 0.99]) |
+-------------------------------------+
| []                                  |
+-------------------------------------+
Report issue