[ ] (tanda kurung siku) operator

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime

Menampilkan elemen array atau nilai peta yang diberi indeks atau kunci.

Sintaks

expr [ keyExpr ]

Perhatikan bahwa penggunaan tanda kurung di sini adalah sebagai teks literal dan tidak menunjukkan sintaks opsional.

Argumen

  • expr:Ekspresi ARRAY atau MAP.
  • keyExpr: Jika expr array adalah numerik integral. Jika tidak, ekspresi yang cocok dengan jenis kunci MAP.

Mengembalikan

Jenis hasilnya adalah jenis elemen ARRAY atau tipe nilai MAP.

Elemen pertama dari ARRAY berada pada indeks 0.

Jika keyExpr bukan kunci yang valid untuk MAP expr Azure Databricks mengembalikan null.

Jika keyExpr berada di luar batas untuk ARRAY expr, Azure Databricks menimbulkan kesalahan INVALID_ARRAY_INDEX.

Catatan

Di Databricks Runtime, jika spark.sql.ansi.enabled adalah false, operator mengembalikan NULL alih-alih kesalahan di luar batas.

Kondisi kesalahan umum

Contoh

> 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