Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Funzione
Si applica a:
Databricks SQL Databricks Runtime 13.3 LTS e versioni successive
Restituisce un array espanso in cui elem viene inserito nella posizione index.
Sintassi
array_insert(array, index, elem)
Argomenti
-
array: array. -
index: espressione INTEGER diversa da zero che specifica dove inserireelem. Se l'indice è negativoelemviene inserito rispetto alla fine della matrice. -
elem: espressione dello stesso tipo degli elementi diarray.
Valori restituiti
Un array 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 è al di fuori della cardinalità di array, l'array viene riempito 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"]