Delen via

array_insert-functie

  • Artikel

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

Retourneert een uitgevouwen array positie waar elem wordt ingevoegd index .

Syntaxis

array_insert(array, index, elem)

Argumenten

  • array: een MATRIX.
  • index: Een niet-nul INTEGER-expressie die aangeeft waar moet worden ingevoegd elem. 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 MATRIX 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 deze zich buiten de kardinaliteit van array de matrix bevindt, wordt opgevuld 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"]