Função de agregação collect_list
Aplica-se a: SQL do Databricks Runtime do Databricks
Retorna uma matriz que consiste em todos os valores em expr
dentro do grupo. Essa função é um sinônimo para a função de agregação array_agg.
Sintaxe
collect_list ( [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 ARRAY 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á somente valores únicos e será um sinônimo para a função de agregação collect_set.
Exemplos
> SELECT collect_list(col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
[1,2,1]
> SELECT collect_list(DISTINCT col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
[1,2]