適用対象:
Databricks SQL Databricks Runtime 13.3 LTS 以上
array の位置に elem を挿入して拡張された index を返します。
構文
array_insert(array, index, elem)
引数
-
array: 配列。 -
index:elemを挿入する場所を指定する 0 以外の INTEGER 式。 インデックスが負の場合は、elemは配列の末尾を基準にして挿入されます。 -
elem:arrayの要素と同じ型の式。
返品
array と同じ型の配列。
メモ
index で始まるすべての要素の位置は、elem で index のためのスペースを確保するために 1 つシフトされます。
index が array のカーディナリティの外側にある場合、配列には NULL が埋め込まれます。
例
> SELECT array_insert(array('a', 'b', 'c'), 1, 'z');
["z","a","b","c"]
> SELECT array_insert(array('a', 'b', 'c'), 0, 'z');
Error
> SELECT array_insert(array('a', 'b', 'c'), -1, 'z');
["a","b","c","z"]
> SELECT array_insert(array('a', 'b', 'c'), 5, 'z');
["a","b","c",NULL,"z"]
> SELECT array_insert(array('a', 'b', 'c'), -5, 'z');
["z",NULL,"a","b","c"]
> SELECT array_insert(array('a', 'b', 'c'), 2, cast(NULL AS STRING));
["a",NULL,"b","c"]