Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:
Databricks SQL
Databricks Runtime 13.3 LTS und höher
Gibt einen erweiterten array-Wert zurück, bei dem elem an der index-Position eingefügt wird.
Syntax
array_insert(array, index, elem)
Argumente
-
array: Ein ARRAY. -
index: Ein Ausdruck ohne Null INTEGER, der angibt, woelemeingefügt werden soll. Wenn der Index negativelemrelativ zum Ende des Arrays eingefügt wird. -
elem: Ein Ausdruck desselben Typs wie die Elemente vonarray
Gibt zurück
Ein ARRAY desselben Typs wie array.
Hinweise
Alle Elemente, die mit index beginnen, werden um eine Position verschoben, um Platz für elem bei index zu schaffen.
Wenn index außerhalb der Kardinalität von array ist, wird das Array mit NULLs aufgefüllt.
Beispiele
> 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"]