array_insert-Funktion

  • Artikel

Gilt für: Häkchen gesetzt ja Databricks SQL Häkchen gesetzt ja 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, wo elem eingefügt werden soll. Wenn der Index negativ elem relativ zum Ende des Arrays eingefügt wird.
  • elem: Ein Ausdruck desselben Typs wie die Elemente von array

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