类别：: 半结构化和结构化数据函数（数组/对象）

ARRAY_PREPEND¶

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

另请参阅：: ARRAY_APPEND、ARRAY_INSERT

语法¶

ARRAY_PREPEND( <array> , <new_element> )

Copy

实参¶

array: 源数组。
new_element: 要添加到开头的元素。

返回¶

这将返回更新的数组。

使用说明¶

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

示例¶

下方的示例展示前置元素放置在数组的开头：

SELECT ARRAY_PREPEND(ARRAY_CONSTRUCT(0,1,2,3),'hello');
+-------------------------------------------------+
| ARRAY_PREPEND(ARRAY_CONSTRUCT(0,1,2,3),'HELLO') |
|-------------------------------------------------|
| [                                               |
|   "hello",                                      |
|   0,                                            |
|   1,                                            |
|   2,                                            |
|   3                                             |
| ]                                               |
+-------------------------------------------------+

Copy