类别：

:doc:`/sql-reference/functions-semistructured`（数组/对象）

ARRAY_APPEND

返回一个包含源数组的所有元素以及新元素的数组。新元素位于数组的末尾。

另请参阅：

ARRAY_INSERT、ARRAY_PREPEND

语法

ARRAY_APPEND( <array> , <new_element> )
Copy

实参

array

源数组。

new_element

要追加的元素。元素的类型取决于数组的类型：

  • 如果 array 是 半结构化 ARRAY，则该元素几乎可以是任何数据类型。数据类型不需要与数组中现有元素的数据类型匹配。

  • 如果 array 是 结构化的 ARRAY，则新元素的类型必须对该类型的 ARRAY 具有 强制性。

返回

返回值的数据类型是 ARRAY。

使用说明

  • 当您将 结构化 ARRAY 传递给该函数时，该函数会返回相同类型的结构化 ARRAY。

示例

这个简单示例说明了如何构建数组（使用 ARRAY_CONSTRUCT 函数），然后再追加到该数组。请注意，追加的元素不需要与数组中的其他元素的数据类型相同。

执行查询：

SELECT ARRAY_APPEND(ARRAY_CONSTRUCT(1, 2, 3), 'HELLO');
+-------------------------------------------------+
| ARRAY_APPEND(ARRAY_CONSTRUCT(1, 2, 3), 'HELLO') |
|-------------------------------------------------|
| [                                               |
|   1,                                            |
|   2,                                            |
|   3,                                            |
|   "HELLO"                                       |
| ]                                               |
+-------------------------------------------------+
Copy
语言: 中文