string_agg(expression, separator) une los valores de cada grupo en un solo texto, y array_agg(expression) los reúne en un array. Pon ORDER BY dentro de la llamada para controlar el orden: string_agg(name, ', ' ORDER BY name).
IT devuelve Bo, Kim, Li y {6100,4800,3900}; Sales devuelve Ana, Raj y {5000,4200}. Los dos son agregados normales como count o sum: trabajan por grupo con GROUP BY, y sobre toda la tabla sin él.
Ordenar los valores
Sin ORDER BY dentro del agregado, los valores salen en el orden en que llegan las filas, que puede cambiar de una ejecución a otra. Un ORDER BY al final de la consulta ordena las filas del resultado, no los valores dentro de cada texto. El ORDER BY interno va después del último argumento, sin coma:
string_agg(name, ', ' ORDER BY hired_on DESC)
array_agg(name ORDER BY score DESC, name)
Quitar duplicados con DISTINCT
Ada compró un bolígrafo dos veces, pero DISTINCT lo muestra una sola: book, pen. Con DISTINCT, el ORDER BY solo puede usar el valor agregado. Ordenar por otra columna falla con "in an aggregate with DISTINCT, ORDER BY expressions must appear in argument list".
Cómo se comportan NULL y los grupos vacíos
string_agg se salta los valores NULL y devuelve Bo, Li. array_agg los conserva: {Bo,Li,NULL}. Para quitar los NULL de array_agg, añade FILTER (WHERE name IS NOT NULL).
Sobre cero filas los dos devuelven NULL, no un texto vacío ni un array vacío. Envuélvelos cuando quien llama espera un valor: COALESCE(string_agg(...), '') o COALESCE(array_agg(...), '{}').
Agregar solo algunas filas con FILTER
FILTER (WHERE ...) limita un agregado a las filas que cumplen la condición, mientras el resto de la consulta las ve todas:
IT tiene 3 personas y lista Bo, Li; Sales tiene 2 y lista Ana.
Añadir una lista a cada fila de otra tabla
Para mostrar a cada cliente con la lista de sus productos, agrega en una subconsulta, así la consulta exterior no necesita 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;
Los clientes sin pedidos siguen en el resultado, con products en NULL. Un join con GROUP BY solo los conserva si es un LEFT JOIN.
Errores comunes y variantes
- Números:
string_aggrecibe texto, así questring_agg(id, ',')falla con "function string_agg(integer, unknown) does not exist". Conviértelo:string_agg(id::text, ','). - Los N primeros por grupo: recorta el array ordenado,
(array_agg(name ORDER BY salary DESC))[1:2]. - Salida en JSON:
json_aggyjsonb_aggreúnen filas en un array JSON, yjsonb_object_agg(key, value)construye un objeto; consulta JSONB. - Si ya tienes un array:
array_to_string(arr, ', ')une un array existente, yunnestlo vuelve a convertir en filas (arrays). - Versión de ventana: los dos funcionan también como funciones de ventana, por ejemplo
string_agg(name, ', ') OVER (PARTITION BY dept)para mostrar la lista completa en cada fila.
Preguntas frecuentes
¿Cuál es el equivalente de GROUP_CONCAT en PostgreSQL?
string_agg(column, ','). A diferencia del GROUP_CONCAT de MySQL, el separador es obligatorio, y el orden va dentro de la llamada: string_agg(name, ', ' ORDER BY name).
¿Cómo uso string_agg con números?
Convierte el valor a texto: string_agg(id::text, ','). string_agg solo acepta texto (o bytea), así que un argumento entero falla con "function string_agg(integer, unknown) does not exist".
¿string_agg tiene un límite de longitud?
No tiene un límite propio; el resultado es un valor text normal, que admite hasta 1 GB. El GROUP_CONCAT de MySQL corta en group_concat_max_len, pero PostgreSQL no corta nada.
¿Cómo obtengo los N primeros valores con array_agg?
Ordena dentro del agregado y recorta el resultado: (array_agg(name ORDER BY score DESC))[1:3] devuelve los tres primeros nombres de cada grupo.