メインコンテンツまでスキップ
バージョン: 3.1

array_agg

説明​

列の値（NULLを含む）を集約して配列にし（複数行を1行に）、特定の列で要素を並べ替えることができます。バージョン3.0から、array_agg()はORDER BYを使用して要素を並べ替えることをサポートしています。

構文​

ARRAY_AGG([distinct] col [order by col0 [desc | asc] [nulls first | nulls last] ...])

パラメータ​

  • col: 集約したい列の値。サポートされているデータ型は、BOOLEAN、TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、VARCHAR、CHAR、DATETIME、DATE、ARRAY（v3.1から）、MAP（v3.1から）、STRUCT（v3.1から）です。

  • col0: colの順序を決定する列。ORDER BY列は複数指定することができます。

  • [desc | asc]: col0の昇順（デフォルト）または降順で要素を並べ替えるかどうかを指定します。

  • [nulls first | nulls last]: NULL値を最初または最後に配置するかを指定します。

戻り値​

col0でオプションで並べ替えられたARRAY型の値を返します。

使用上の注意​

  • 配列内の要素の順序はランダムであり、ORDER BY列が指定されていない場合や並べ替え順序が指定されていない場合、列内の値の順序と異なる可能性があります。
  • 返される配列内の要素のデータ型は、列内の値のデータ型と同じです。
  • 入力が空でグループ化列がない場合、NULLを返します。
  • ARRAY_AGG_DISTINCT()はARRAY_AGG(DISTINCT)のエイリアスです。

例​

以下のデータテーブルを例にとります：

mysql> select * from t;
+------+------+------+
| a    | name | pv   |
+------+------+------+
|   11 |      |   33 |
|    2 | NULL |  334 |
|    1 | fzh  |    3 |
|    1 | fff  |    4 |
|    1 | fff  |    5 |
+------+------+------+

例1: 列aの値をグループ化し、列pvの値をnameで並べ替えて配列に集約します。

mysql> select a, array_agg(pv order by name nulls first) from t group by a;
+------+---------------------------------+
| a    | array_agg(pv ORDER BY name ASC) |
+------+---------------------------------+
|    2 | [334]                           |
|   11 | [33]                            |
|    1 | [4,5,3]                         |
+------+---------------------------------+

-- 順序なしで値を集約します。
mysql> select a, array_agg(pv) from t group by a;
+------+---------------+
| a    | array_agg(pv) |
+------+---------------+
|   11 | [33]          |
|    2 | [334]         |
|    1 | [3,4,5]       |
+------+---------------+
3 rows in set (0.03 sec)

例2: 列pvの値をnameで並べ替えて配列に集約します。

mysql> select array_agg(pv order by name desc nulls last) from t;
+----------------------------------+
| array_agg(pv ORDER BY name DESC) |
+----------------------------------+
| [3,4,5,33,334]                   |
+----------------------------------+
1 row in set (0.02 sec)

-- 順序なしで値を集約します。
mysql> select array_agg(pv) from t;
+----------------+
| array_agg(pv)  |
+----------------+
| [3,4,5,33,334] |
+----------------+
1 row in set (0.03 sec)

例3: WHERE句を使用して列pvの値を集約します。pv内のデータがフィルター条件を満たさない場合、NULL値が返されます。

mysql> select array_agg(pv order by name desc nulls last) from t where a < 0;
+----------------------------------+
| array_agg(pv ORDER BY name DESC) |
+----------------------------------+
| NULL                             |
+----------------------------------+
1 row in set (0.02 sec)

-- 順序なしで値を集約します。
mysql> select array_agg(pv) from t where a < 0;
+---------------+
| array_agg(pv) |
+---------------+
| NULL          |
+---------------+
1 row in set (0.03 sec)

キーワード​

ARRAY_AGG, ARRAY