Dela via

Funktionen array_insert

  • Artikel

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 13.3 LTS och senare

Returnerar en expanderad arraywhereelem infogas på index-positionen.

Syntax

array_insert(array, index, elem)

Argument

  • array: En MATRIS.
  • index: Ett heltalsuttryck som inte är noll och som anger where till insertelem. Om indexet är negativt elem infogas i förhållande till matrisens slut.
  • elem: Ett uttryck av samma typ som elementen arrayi .

Returer

En MATRIS av samma typ som array.

Kommentar

Alla element som börjar med index flyttas med en position för att göra plats för elem på index. Om index ligger utanför matrisens array kardinalitet är vadderad med NULLs.

Exempel

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