[ ] Operátor (znaménko závorky)

Platí pro:check označeno ano Kontrola Databricks SQL označená ano Databricks Runtime

Vrátí maticový prvek nebo hodnotu mapování zadanou indexem nebo klíčem.

Syntaxe

expr [ keyExpr ]

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

Argumenty

  • expr: Výraz ARRAY nebo MAP.
  • keyExpr: Je-li expr pole celočíselnou číslicí. V opačném případě výraz odpovídající typu klíče MAP.

Vrátí

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

První prvek pole je v indexu 0.

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

keyExpr Pokud je hodnota mimo vazbu pro pole ARRAYexpr, Azure Databricks vyvolá INVALID_ARRAY_INDEXchybu.

Poznámka

V modulu Databricks Runtime, pokud je falsespark.sql.ansi.enabled , vrátí NULL operátor místo chyby mimo rozsah.

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