collect_list aggregate function

Returns an array consisting of all values in expr within the group.


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


  • expr: An expression of any type.

  • cond: An optional boolean expression filtering the rows used for aggregation.


An ARRAY of the argument type.

The order of elements in the array is non-deterministic. NULL values are excluded.

If DISTINCT is specified the function collects only unique values and is a synonym for collect_set aggregate function

This function is a synonym for array_agg


> SELECT collect_list(col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
> SELECT collect_list(DISTINCT col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);