Fonction array_insert

S’applique à : Databricks SQL Databricks Runtime 13.3 LTS et versions ultérieures

Retourne un développé array où elem est inséré à la index position.

Syntaxe

array_insert(array, index, elem)

Arguments

• array : un tableau.
• index : expression INTEGER non nulle spécifiant où insérer elem. Si l’index est négatif, elem est inséré par rapport à la fin du tableau.
• elem : expression du même type que les éléments de array.

Retours

Un tableau du même type que array.

Notes

Tous les éléments commençant par index sont décalés d’une position afin de faire de l’espace pour elem à index. Si index est en dehors de la cardinalité de array, le tableau est rempli avec des NULL.

Exemples

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

Fonctions connexes

• Fonction array_append
• array_position, fonction
• array_prepend, fonction
• Fonction array_remove