Condividi tramite

Funzione array_insert

  • Articolo

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 13.3 LTS e versioni successive

Restituisce un oggetto espanso in array cui elem viene inserito in corrispondenza della index posizione.

Sintassi

array_insert(array, index, elem)

Argomenti

  • array: matrice.
  • index: espressione INTEGER diversa da zero che specifica dove inserire elem. Se l'indice è negativo elem viene inserito rispetto alla fine della matrice.
  • elem: espressione dello stesso tipo degli elementi di array.

Valori restituiti

Matrice dello stesso tipo di array.

Note

Tutti gli elementi che iniziano con index vengono spostati di una posizione per fare spazio per elem in index. Se index non è compresa la cardinalità della array matrice viene riempita con NULLs.

Esempi

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