Compartilhar via


Função de agregação collect_list

Aplica-se a: marca de seleção positiva SQL do Databricks verificação marcada como sim 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]