次の方法で共有

[ ] (角かっこ記号) 演算子

  • [アーティクル]

適用対象: 「はい」のチェック マーク Databricks SQL 「はい」のチェック マーク Databricks Runtime

インデックスまたはキーが指定された配列要素またはマップ値を返します。

構文

expr [ keyExpr ]

ここでの角かっこの使用はリテラル テキストであり、オプションの構文を示すものではないことにご注意ください。

引数

  • expr: 配列またはマップ式。
  • keyExpr: expr が配列で整数型の場合。 それ以外の場合は、マップのキーの型と一致する式。

戻り値

結果の型は、配列の要素型またはマップの値型です。

配列の最初の要素はインデックス 0 にあります。

keyExpr が MAP expr に対して有効なキーではない場合、Azure Databricks は null を返します。

keyExpr が ARRAY の範囲外の場合、expr Azure Databricks で INVALID_ARRAY_INDEX エラーが発生します。

注意

Databricks Runtime で spark.sql.ansi.enabled が false の場合、この演算子は、非バインドエラーではなく、NULL を返します。

例

> 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