array_insert
函式
適用於: Databricks SQL Databricks Runtime 13.3 LTS 和更新版本
傳回已展開的 array
whereelem
,並將其插入到 index
位置。
語法
array_insert(array, index, elem)
引數
-
array
:ARRAY。 -
index
:一個非零的 INTEGER 表達式,指定 where 要 insertelem
。 如果索引是負elem
數,則會相對於數位的結尾插入。 -
elem
:與 專案相同類型的array
表達式。
傳回
與相同型 array
別的 ARRAY。
備註
開頭index
的所有元素都會依一個位置移位,以在 上空間elem
index
。
如果 index
超出陣列的 array
基數,則會以 NULL
s 填補。
範例
> 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"]