Função de agregação array_agg

Aplica-se a: Databricks SQL Databricks Runtime 10.4 LTS e superior

Retorna uma matriz que consiste em todos os valores em expr dentro do grupo. Essa função é um sinônimo para collect_list a função de agregação.

Sintaxe

array_agg ( [ALL | DISTINCT] expr ) [FILTER ( WHERE cond ) ]

Essa função também pode ser invocada como uma função de janela usando a cláusula OVER.

Argumentos

• expr: uma expressão de qualquer tipo.
• cond: uma expressão booliana opcional que filtra as linhas usadas para agregação.

Retornos

Uma MATRIZ do tipo de argumento.

A ordem dos elementos na matriz é não determinística. Os valores NULL são excluídos.

Se DISTINCT for especificado, a função coletará apenas valores exclusivos e será um sinônimo para collect_set a função de agregação.

Exemplos

> SELECT array_agg(col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
 [1,2,1]
> SELECT array_agg(DISTINCT col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
 [1,2]

Funções relacionadas

• array função
• collect_list função de agregação
• collect_set função de agregação
• Funções da janela