[ ] Operator (hakparentes)

Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime

Returnerar ett matriselement eller mappningsvärde givet ett index eller en nyckel.

Syntax

expr [ keyExpr ]

Observera att användningen av hakparenteser här är som literaltext och inte anger valfri syntax.

Argument

  • expr: Ett MATRIS- eller MAP-uttryck.
  • keyExpr: Om expr är en MATRIS är en integrerad numerisk. Annars ett uttryck som matchar typen av nyckeln i MAP.

Returer

Resultattypen är elementtypen för MATRISen eller värdetypen för MAP.

Det första elementet i en MATRIS är vid index 0.

Om keyExpr inte är en giltig nyckel för MAP expr Azure Databricks returnerar null.

Om keyExpr är utanför gränsen för ARRAY expr Azure Databricks genereras ett INVALID_ARRAY_INDEX fel.

Kommentar

Om spark.sql.ansi.enabledreturneras false operatorn i stället för ett fel utanför gränserna.

Vanliga felvillkor

Exempel

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