跳到主要内容
版本:Stable-3.1

array_concat

功能

将多个数组拼接成一个数组。拼接后的数组包含多个数组里的所有元素。待拼接的数组元素类型可以相同,也可以不同,但是建议对相同元素类型的数组进行拼接。

NULL 值会作为正常值处理。

语法

array_concat(input0, input1, ...)

参数说明

input:表示不限数量、具有相同元素类型的数组。数组元素可以是以下数据类型:BOOLEAN、TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、DECIMALV2、VARCHAR、DATETIME、DATE、JSON。从 2.5 版本开始,该函数支持 JSON 类型的数组元素。

返回值说明

返回 (input0, input1, ...) 中所有元素有序拼接后的数组。

返回的数组元素类型与 input 中数组的元素类型一致。

示例

示例一:对数值元素的数组进行拼接。

mysql> 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] |
+-------------------------------------+

示例二:对字符串元素的数组进行拼接。

mysql> select array_concat(["sql","storage","execute"], ["Query"], ["Vectorized", "cbo"]);
+----------------------------------------------------------------------------+
| array_concat(['sql','storage','execute'], ['Query'], ['Vectorized','cbo']) |
+----------------------------------------------------------------------------+
| ["sql","storage","execute","Query","Vectorized","cbo"] |
+----------------------------------------------------------------------------+

示例三:对不同元素类型的数组进行拼接。

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

示例四:null作为正常值处理。

mysql> select array_concat(["sql",null], [null], ["Vectorized", null]);
+---------------------------------------------------------+
| array_concat(['sql',NULL], [NULL], ['Vectorized',NULL]) |
+---------------------------------------------------------+
| ["sql",null,null,"Vectorized",null] |
+---------------------------------------------------------+