Compartilhar via

posexplode_outer Função geradora com valor de tabela

  • Artigo

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

Retorna linhas com o desaninhamento da matriz com a numeração de posições usando a semântica OUTER.

Sintaxe

posexplode_outer(expr)

Argumentos

  • expr: uma expressão ARRAY ou MAP.

Retornos

Um conjunto de linhas composto pela posição e pelos elementos da matriz ou as chaves e valores do mapa. As colunas produzidas por posexplode_outer de uma matriz são nomeadas pos e col. As colunas de um mapa são chamadas de pos, key e value .

Se expr for NULL, uma única linha com NULLs para os valores de matriz ou mapa.

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

    posexplode_outer 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 simSQL do Databricks verificação marcada como sim Databricks Runtime 12.2 LTS e superior:

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

Exemplos

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

> SELECT posexplode_outer(array(10, 20)) AS elem, 'Spark';
 0  10 Spark
 1  20 Spark

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

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

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

> SELECT pos, col FROM posexplode_outer(array(10, 20));
 0  10
 1  20

> SELECT pos, key, value FROM posexplode_outer(map(10, 'a', 20, 'b'));
 0  10   a
 1  22   b

> SELECT p1.*, p2.* FROM posexplode_outer(array(1, 2)) AS p1, posexplode_outer(array(3, 4)) AS p2;
 0  1  0  3
 0  1  1  4
 1  2  0  3
 1  2  1  4

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