collect_list função agregar

Aplica-se a: Databricks SQL Databricks Runtime

Retorna uma matriz que consiste em todos os valores dentro expr do grupo. Esta função é sinónimo de array_agg função agregada.

Sintaxe

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

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

Argumentos

• expr: Uma expressão de qualquer tipo.
• cond: Uma expressão booleana opcional filtrando as linhas usadas para agregação.

Devoluções

Um ARRAY do tipo de argumento.

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

Se DISTINCT for especificada, a função coleta apenas valores exclusivos e é sinônimo de collect_set função agregada.

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]

Relacionada

• array_agg função agregada
• função de matriz
• collect_set função agregada
• Funções do Windows