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 geen geldige sleutel is voor de MAP-expr Azure Databricks null retourneert.

Als de keyExpr niet is gebonden aan de matrix-expr, Azure Databricks een fout INVALID_ARRAY_INDEX veroorzaakt.

Notitie

Als in Databricks Runtime spark.sql.ansi.enabledretourneert false de operator in plaats van een fout buiten de grenzen.

Algemene foutvoorwaarden

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

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