Menu

string_agg e array_agg no PostgreSQL (GROUP_CONCAT)

string_agg junta os valores de um grupo num único texto e array_agg os reúne num array. Ordenação, DISTINCT, FILTER, tratamento de NULL e os erros mais comuns.

Esta página tem editores executáveis. Edite, execute e veja a saída na hora.

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_agg recebe texto, então string_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_agg e jsonb_agg reúnem linhas num array JSON, e jsonb_object_agg(key, value) monta um objeto; veja JSONB.
  • Se você já tem um array: array_to_string(arr, ', ') junta um array existente, e unnest o 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.

Ilustração das linguagens de programação do Coddy

Aprenda a programar com o Coddy

Começar