Delen via

[ ] Operator (haakteken)

Van toepassing op: vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime

Retourneert een matrixelement of toewijzingswaarde op basis van een index of sleutel.

Syntaxis

expr [ keyExpr ]

Houd er rekening mee dat het gebruik van vierkante haken hier als letterlijke tekst is en geen optionele syntaxis aangeeft.

Argumenten

  • expr: Een MATRIX- of MAP-expressie.
  • keyExpr: Als expr een MATRIX een integraal numerieke waarde is. Anders is er een expressie die overeenkomt met het type sleutel van de MAP.

Retouren

Het resultaattype is het elementtype van de MATRIX of het waardetype van de KAART.

Het eerste element van een MATRIX bevindt zich op index 0.

Als de keyExpr sleutel geen geldige sleutel is voor de MAP expr Azure Databricks, wordt null geretourneerd.

Als de keyExpr waarde buiten de grenzen van de MATRIX expr Azure Databricks valt, wordt er een INVALID_ARRAY_INDEXfout gegenereerd.

Notitie

Als in Databricks Runtime spark.sql.ansi.enabled isfalse, retourneert NULL de operator in plaats van een fout buiten de grenzen.

Voorbeelden

> 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