Funktionen array_insert

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.

Azure Databricks genererar INVALID_INDEX_OF_ZERO om index är 0.

Azure Databricks höjer COLLECTION_SIZE_LIMIT_EXCEEDED om resultatet överskrider matrisstorleksgränsen.

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.

Vanliga felvillkor

Exempel

> SELECT array_insert(array('a', 'b', 'c'), 1, 'z');
 ["z","a","b","c"]

> SELECT array_insert(array('a', 'b', 'c'), 0, 'z');
 Error: INVALID_INDEX_OF_ZERO

> 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"]
  • Last updated on