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 array där elem infogas på index position.

Syntax

array_insert(array, index, elem)

Argument

  • array: En MATRIS.
  • index: Ett heltalsuttryck som inte är noll och som anger var elemska infogas. 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"]