Compartilhar via


explode Função geradora com valor de tabela

Aplica-se a: marca de seleção positiva SQL do Databricks marca de seleção positiva Databricks Runtime

Retorna um conjunto de linhas desinstalando collection.

No Databricks SQL e Databricks Runtime 13.3 LTS e versões superiores, esta função dá suporte à invocação de parâmetro nomeada.

Sintaxe

explode(collection)

Argumentos

  • collection: Uma expressão ARRAY ou MAP.

Retornos

Um conjunto de linhas composto pelos elementos da matriz ou as chaves e valores do mapa. A coluna produzida por explode de uma matriz é chamada col. As colunas de um mapa são chamadas de key e value.

Se collection for NULL, nenhuma linha será produzida.

  • Aplica-se a: verificação marcada como sim Databricks Runtime 12.1 e anterior:

    explode só pode ser colocado na lista SELECT como a raiz de uma expressão ou seguindo uma EXIBIÇÃO LATERAL. Ao colocar a função na lista SELECT, não deve haver nenhuma outra função de gerador na mesma lista SELECT ou um UNSUPPORTED_GENERATOR. MULTI_GENERATOR será gerado.

  • Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 12.2 LTS e versões posteriores:

    A invocação a partir da cláusula EXIBIÇÃO LATERAL ou da lista SELECT foi preterida. Em vez disso, invoque explode como uma table_reference.

Exemplos

Aplica-se a:Databricks SQL com SQL do Databricks verificação marcada como sim Databricks Runtime 12.1 e versões anteriores

> SELECT explode(array(10, 20)) AS elem, 'Spark';
 10 Spark
 20 Spark

> SELECT explode(map(1, 'a', 2, 'b')) AS (num, val), 'Spark';
 1   a   Spark
 2   b   Spark

> SELECT explode(array(1, 2)), explode(array(3, 4));
  Error: UNSUPPORTED_GENERATOR.MULTI_GENERATOR

Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 12.2 LTS e versões posteriores:

> SELECT elem, 'Spark' FROM explode(array(10, 20)) AS t(elem);
 10 Spark
 20 Spark

> SELECT num, val, 'Spark' FROM explode(map(1, 'a', 2, 'b')) AS t(num, val);
 1   a   Spark
 2   b   Spark

> SELECT * FROM explode(array(1, 2)), explode(array(3, 4));
 1   3
 1   4
 2   3
 2   4

-- Using lateral correlation in Databricks 12.2 and above
> SELECT * FROM explode(array(1, 2)) AS t, LATERAL explode(array(3 * t.col, 4 * t.col));
 1   3
 1   4
 2   6
 2   8