Sdílet prostřednictvím

Funkce array_insert

  • Článek

Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 13.3 LTS a vyšší

Vrátí rozbalené array místo, kam elem se vloží na index pozici.

Syntaxe

array_insert(array, index, elem)

Argumenty

  • array:Pole.
  • index: Nenulový výraz INTEGER určující, kam se má vložit elem. Pokud je index záporný elem , vloží se vzhledem ke konci pole.
  • elem: Výraz stejného typu jako prvky array.

Návraty

POLE stejného typu jako array.

Notes

Všechny prvky začínající na index jedné pozici jsou posunuty o jednu pozici, aby prostor pro elem index. Pokud index je mimo kardinalitu array pole, je vycpaný s NULL.

Příklady

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