適用於:
Databricks SQL
Databricks Runtime 13.3 LTS 及更新的版本
傳回將 array 插入到 elem 位置後展開的 index。
語法
array_insert(array, index, elem)
引數
-
array:ARRAY。 -
index:非零整數運算式,指定要插入elem的位置。 如果索引是負數,則會相對於陣列的結尾插入。 -
elem:與array元素相同類型的表達式。
退貨
與 array 相同類型的陣列。
備註
開頭為index的所有元素會移動一個位置,以便在elem為index騰出空間。
如果 index 超出陣列的 array 基數,則會以 NULLs 填補。
範例
> 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"]