Udostępnij za pośrednictwem

[ ] (znak nawiasu) — operator

Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime

Zwraca element tablicy lub wartość mapy, biorąc pod uwagę indeks lub klucz.

Składnia

expr [ keyExpr ]

Należy pamiętać, że użycie nawiasów kwadratowych w tym miejscu jest tekstem literału i nie wskazuje składni opcjonalnej.

Argumenty

  • expr: wyrażenie ARRAY lub MAP.
  • keyExpr: Jeśli expr jest tablicą liczbową całkowitą. W przeciwnym razie wyrażenie pasujące do typu klucza mapowania.

Zwraca

Typ wyniku jest typem elementu ARRAY lub typem wartości MAP.

Pierwszym elementem tablicy jest indeks 0.

Jeśli keyExpr nie jest prawidłowym kluczem map expr Azure Databricks zwraca wartość null.

Jeśli keyExpr jest poza granicą tablicy expr, Azure Databricks zgłasza błąd INVALID_ARRAY_INDEX.

Uwaga

Jeśli w środowisku Databricks Runtime spark.sql.ansi.enabled to false, operator zwraca NULL wartość zamiast błędu poza granicami.

Typowe warunki błędów

Przykłady

> 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