Delen via

array_insert functie

Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger

Retourneert een uitgevouwen array waar elem wordt ingevoegd op de index positie.

Syntaxis

array_insert(array, index, elem)

Argumenten

  • array: een ARRAY.
  • index: een expressie die niet nul integer is die aangeeft waar elemmoet worden ingevoegd. Als de index negatief elem is, wordt ten opzichte van het einde van de matrix ingevoegd.
  • elem: Een expressie van hetzelfde type als de elementen van array.

Retouren

Een ARRAY van hetzelfde type als array.

Opmerkingen

Alle elementen die beginnen met index , worden met één positie verschoven om ruimte te maken op elemindex. Als index buiten de kardinaliteit van array valt, wordt de array aangevuld met NULLs.

Voorbeelden

> 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"]
  • Last updated on