[ ] (znaménko závorky) – operátor

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

Vrátí maticový prvek nebo hodnotu mapy s indexem nebo klíčem.

Syntaxe

expr [ keyExpr ]

Všimněte si, že použití závorek je zde jako literálový text, a ne indikuje volitelnou syntaxi.

Argumenty

  • expr: Výraz ARRAY nebo MAP.
  • keyExpr: Pokud expr je funkce ARRAY celočíselnou číselnou sadou. V opačném případě výraz odpovídající typu klíče map.

Návraty

Typ výsledku je typ prvku POLE nebo typ hodnoty MAP.

První prvek pole je na indexu 0.

Pokud keyExpr není platný klíč pro mapový expr Azure Databricks vrátí hodnotu null.

Pokud je keyExpr pro expr mimo vazbu, Azure Databricks vyvolá chybu INVALID_ARRAY_INDEX.

Poznámka:

Pokud je v modulu Databricks Runtime spark.sql.ansi.enabledfalse, vrátí NULL operátor místo chyby mimo hranice.

Běžné chybové podmínky

Příklady

> SELECT a[2] FROM VALUES(array(10, 20, 30)) AS T(a);
  30

> SELECT m[1] FROM VALUES(map(1, 'Hello', 2, 'World')) AS T(m);
  Hello

> SELECT array(1, 2, 3)[5];
  Error: INVALID_ARRAY_INDEX