Udostępnij za pośrednictwem

Funkcja array_insert

  • Artykuł

Dotyczy: zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 13.3 LTS i nowsze

Zwraca rozwinięty array obiekt, w którym elem jest wstawiony w index miejscu.

Składnia

array_insert(array, index, elem)

Argumenty

  • array:Tablicy.
  • index: Wyrażenie niezerowe liczby całkowitej określające, gdzie należy wstawić elemelement . Jeśli indeks jest ujemny elem , jest wstawiany względem końca tablicy.
  • elem: wyrażenie tego samego typu co elementy elementu array.

Zwraca

Tablica tego samego typu co array.

Uwagi

Wszystkie elementy rozpoczynające się od index elementu są przesunięte o jedną pozycję, aby zwolnić miejsce na elem .index Jeśli index element znajduje się poza kardynalnością array tablicy, jest wypełniony s NULL.

Przykłady

> 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"]