string_agg(expression, separator) junta os valores de cada grupo num único texto, e array_agg(expression) os reúne num array. Coloque ORDER BY dentro da chamada para controlar a ordem: string_agg(name, ', ' ORDER BY name).
IT retorna Bo, Kim, Li e {6100,4800,3900}; Sales retorna Ana, Raj e {5000,4200}. As duas são agregações comuns como count ou sum: funcionam por grupo com GROUP BY, e sobre a tabela inteira sem ele.
Ordenar os valores
Sem ORDER BY dentro da agregação, os valores vêm na ordem em que as linhas chegam, que pode mudar de uma execução para outra. Um ORDER BY no fim da consulta ordena as linhas do resultado, não os valores dentro de cada texto. O ORDER BY interno vai depois do último argumento, sem vírgula:
string_agg(name, ', ' ORDER BY hired_on DESC)
array_agg(name ORDER BY score DESC, name)
Remover duplicados com DISTINCT
A Ada comprou uma caneta duas vezes, mas o DISTINCT a lista uma vez só: book, pen. Com DISTINCT, o ORDER BY só pode usar o valor agregado. Ordenar por outra coluna falha com "in an aggregate with DISTINCT, ORDER BY expressions must appear in argument list".
Como NULL e grupos vazios se comportam
string_agg ignora valores NULL e retorna Bo, Li. array_agg os mantém: {Bo,Li,NULL}. Para tirar os NULL do array_agg, adicione FILTER (WHERE name IS NOT NULL).
Sobre zero linhas, as duas retornam NULL, não um texto vazio nem um array vazio. Envolva-as quando quem chama espera um valor: COALESCE(string_agg(...), '') ou COALESCE(array_agg(...), '{}').
Agregar só algumas linhas com FILTER
FILTER (WHERE ...) limita uma agregação às linhas que batem com a condição, enquanto o resto da consulta vê todas:
IT tem 3 pessoas e lista Bo, Li; Sales tem 2 e lista Ana.
Anexar uma lista a cada linha de outra tabela
Para mostrar cada cliente com a lista dos produtos dele, agregue numa subconsulta, assim a consulta de fora não precisa de GROUP BY:
SELECT c.id, c.name, c.email,
(SELECT string_agg(o.product, ', ' ORDER BY o.product)
FROM orders o
WHERE o.customer_id = c.id) AS products
FROM customers c;
Clientes sem pedidos continuam no resultado, com products igual a NULL. Um join com GROUP BY só os mantém se for um LEFT JOIN.
Erros comuns e variações
- Números:
string_aggrecebe texto, entãostring_agg(id, ',')falha com "function string_agg(integer, unknown) does not exist". Converta:string_agg(id::text, ','). - Os N primeiros por grupo: fatie o array ordenado,
(array_agg(name ORDER BY salary DESC))[1:2]. - Saída em JSON:
json_aggejsonb_aggreúnem linhas num array JSON, ejsonb_object_agg(key, value)monta um objeto; veja JSONB. - Se você já tem um array:
array_to_string(arr, ', ')junta um array existente, eunnesto transforma de volta em linhas (arrays). - Versão de janela: as duas também funcionam como funções de janela, por exemplo
string_agg(name, ', ') OVER (PARTITION BY dept)para mostrar a lista inteira em cada linha.
Perguntas frequentes
Qual é o equivalente do GROUP_CONCAT no PostgreSQL?
string_agg(column, ','). Diferente do GROUP_CONCAT do MySQL, o separador é obrigatório, e a ordem vai dentro da chamada: string_agg(name, ', ' ORDER BY name).
Como usar string_agg com números?
Converta o valor para texto: string_agg(id::text, ','). string_agg só aceita texto (ou bytea), então um argumento inteiro falha com "function string_agg(integer, unknown) does not exist".
O string_agg tem limite de tamanho?
Não tem limite próprio; o resultado é um valor text comum, que comporta até 1 GB. O GROUP_CONCAT do MySQL corta em group_concat_max_len, mas o PostgreSQL não corta.
Como pegar os N primeiros valores com array_agg?
Ordene dentro da agregação e fatie o resultado: (array_agg(name ORDER BY score DESC))[1:3] retorna os três primeiros nomes de cada grupo.