array_concat

array_concat

説明

複数の配列を連結し、配列に含まれるすべての要素を含む1つの配列を作成します。

連結する配列の要素は同じ型でも異なる型でも構いませんが、同じ型の要素を推奨します。

ヌル値は通常の値として処理されます。

構文

array_concat(input0, input1, ...)

パラメータ

input: 連結したい1つまたは複数の配列を指定します。(input0, input1, ...) の形式で配列を指定します。この関数は、次のタイプの配列要素をサポートしています: BOOLEAN、TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、VARCHAR、DECIMALV2、DATETIME、DATE、およびJSON。JSONはバージョン2.5からサポートされています。

戻り値

input パラメータで指定された配列に含まれるすべての要素を持つ配列を返します。返される配列の要素は、入力配列の要素と同じデータ型です。さらに、返される配列の要素は入力配列およびその要素の順序に従います。

例

例1: 数値要素を含む配列を連結する場合

select array_concat([57.73,97.32,128.55,null,324.2], [3], [5]) as res;

+-------------------------------------+

| res                                 |

+-------------------------------------+

| [57.73,97.32,128.55,null,324.2,3,5] |

+-------------------------------------+

例2: 文字列要素を含む配列を連結する場合

select array_concat(["sql","storage","execute"], ["Query"], ["Vectorized", "cbo"]);

+----------------------------------------------------------------------------+

| array_concat(['sql','storage','execute'], ['Query'], ['Vectorized','cbo']) |

+----------------------------------------------------------------------------+

| ["sql","storage","execute","Query","Vectorized","cbo"]                     |

+----------------------------------------------------------------------------+

例3: 異なる型の2つの配列を連結する場合

select array_concat([57,65], ["pear","apple"]);
+-------------------------------------------+
| array_concat([57, 65], ['pear', 'apple']) |
+-------------------------------------------+
| ["57","65","pear","apple"]                |
+-------------------------------------------+

例4: ヌル値を通常の値として処理する場合

select array_concat(["sql",null], [null], ["Vectorized", null]);

+---------------------------------------------------------+

| array_concat(['sql',NULL], [NULL], ['Vectorized',NULL]) |

+---------------------------------------------------------+

| ["sql",null,null,"Vectorized",null]                     |

+---------------------------------------------------------+