カテゴリ：: 半構造化データ関数と構造化データ関数（配列/オブジェクト）

ARRAY_PREPEND¶

新しい要素とソース配列のすべての要素を含む配列を返します。新しい要素は配列の先頭に配置されます。

こちらもご参照ください。: ARRAY_APPEND、 ARRAY_INSERT

構文¶

ARRAY_PREPEND( <array> , <new_element> )

引数¶

array: ソース配列です。
new_element: 追加される要素です。

戻り値¶

これにより、更新された配列が返されます。

使用上の注意¶

関数に構造化配列を渡すと、関数は同じ型の構造化配列を返します。
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                                             |
| ]                                               |
+-------------------------------------------------+