A array_insert függvény

  • Cikk

A következőkre vonatkozik:jelölje be az igennel jelölt jelölőnégyzetet Databricks SQL jelölje be az igennel jelölt jelölőnégyzetet Databricks Runtime 13.3 LTS és újabb

Egy kibontott array helyet ad vissza, amely elem a index pozícióba van beszúrva.

Syntax

array_insert(array, index, elem)

Argumentumok

  • array: Tömb.
  • index: Nem nulla EGÉSZ SZÁM kifejezés, amely megadja, hogy hová szúrja be elem. Ha az index negatív elem a tömb végéhez viszonyítva.
  • elem: Azonos típusú kifejezés, mint a array.

Válaszok

A tömb típusa megegyezik arraya .

Jegyzetek

A kezdő index elemeket egy pozícióval eltoljuk, hogy helyet biztosítsunk a következőnek elemindex: . Ha index kívül esik a tömb számosságán array , az s-vel NULLvan párnázva.

Példák

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