array_agg
função agregar
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. Esta função é sinónimo de collect_list função agregada.
Sintaxe
array_agg ( [ALL | DISTINCT] expr ) [FILTER ( WHERE cond ) ]
Esta 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 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
valores são excluídos.
Se DISTINCT
for especificado, a função coletará apenas valores exclusivos e será sinônimo de collect_set função agregada.
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]