カテゴリ:

半構造化データ関数と構造化データ関数 (配列/オブジェクト)

ARRAY_PREPEND

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

こちらもご参照ください。

ARRAY_APPENDARRAY_INSERT

構文

ARRAY_PREPEND( <array> , <new_element> )
Copy

引数

array

ソース配列です。

new_element

追加される要素です。

戻り値

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

使用上の注意

  • 関数に 構造化 ARRAY を渡すと、関数は同じ型の構造化 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