array_insert 函式

  • 發行項

適用於：檢查標示為是 Databricks SQL 檢查標示為是 Databricks Runtime 13.3 LTS 和更新版本

傳回展開array的位置插入index的位置elem。

語法

array_insert(array, index, elem)

引數

  • array：ARRAY。
  • index：非零 INTEGER 運算式，指定要插入 elem的位置。 如果索引是負 elem 數，則會相對於數位的結尾插入。
  • elem：與 專案相同類型的 array表達式。

傳回

與相同型 array別的 ARRAY。

備註

開頭index的所有元素都會依一個位置移位，以在 上空間elemindex。 如果 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"]