Partilhar via

[ ] (sinal de suporte) operador

  • Artigo

Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime

Retorna um elemento de matriz ou valor de mapa dado um índice ou chave.

Sintaxe

expr [ keyExpr ]

Observe que o uso de colchetes aqui é como texto literal e não indica sintaxe opcional.

Argumentos

  • expr: Uma expressão ARRAY ou MAP.
  • keyExpr: Se expr é um ARRAY um numérico integral. Caso contrário, uma expressão correspondente ao tipo da chave do MAP.

Devoluções

O tipo de resultado é o tipo de elemento do ARRAY ou o tipo de valor do MAP.

O primeiro elemento de um ARRAY está no índice 0.

Se o não for uma chave válida para o MAPexpr, keyExpr o Azure Databricks retornará null.

Se o keyExpr estiver fora do limite para o ARRAY expr Azure Databricks gerará um erro INVALID_ARRAY_INDEX.

Nota

No Databricks Runtime, se spark.sql.ansi.enabled for false, o operador retornará NULL em vez de um erro fora dos limites.

Exemplos

> 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