共用方式為


array_insert函式

適用於:核取記號為「是」 Databricks SQL 核取記號為「是」 Databricks Runtime 13.3 LTS 和更新版本

傳回已展開的 arraywhereelem,並將其插入到 index 位置。

語法

array_insert(array, index, elem)

引數

  • array:ARRAY。
  • index:一個非零的 INTEGER 表達式,指定 where 要 insertelem。 如果索引是負 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"]