Menu

string_agg et array_agg PostgreSQL (GROUP_CONCAT)

string_agg concatène les valeurs d'un groupe en une seule chaîne et array_agg les rassemble dans un tableau. Tri, DISTINCT, FILTER, gestion de NULL et les erreurs fréquentes.

Cette page contient des éditeurs exécutables. Modifiez, exécutez et voyez la sortie instantanément.

string_agg(expression, separator) concatène les valeurs de chaque groupe en une seule chaîne, et array_agg(expression) les rassemble dans un tableau. Placez un ORDER BY dans l'appel pour contrôler l'ordre : string_agg(name, ', ' ORDER BY name).

IT renvoie Bo, Kim, Li et {6100,4800,3900} ; Sales renvoie Ana, Raj et {5000,4200}. Les deux sont des agrégats ordinaires comme count ou sum : ils travaillent par groupe avec GROUP BY, et sur toute la table sans.

Trier les valeurs

Sans ORDER BY dans l'agrégat, les valeurs arrivent dans l'ordre où les lignes se présentent, qui peut changer d'une exécution à l'autre. Un ORDER BY à la fin de la requête trie les lignes du résultat, pas les valeurs à l'intérieur de chaque chaîne. Le ORDER BY interne se place après le dernier argument, sans virgule :

string_agg(name, ', ' ORDER BY hired_on DESC)
array_agg(name ORDER BY score DESC, name)

Supprimer les doublons avec DISTINCT

Ada a acheté deux fois un stylo, mais DISTINCT ne le liste qu'une fois : book, pen. Avec DISTINCT, le ORDER BY ne peut utiliser que la valeur agrégée. Trier sur une autre colonne échoue avec "in an aggregate with DISTINCT, ORDER BY expressions must appear in argument list".

Comportement avec NULL et les groupes vides

string_agg ignore les valeurs NULL et renvoie Bo, Li. array_agg les garde : {Bo,Li,NULL}. Pour retirer les NULL d'array_agg, ajoutez FILTER (WHERE name IS NOT NULL).

Sur zéro ligne, les deux renvoient NULL, pas une chaîne vide ni un tableau vide. Enveloppez-les quand l'appelant attend une valeur : COALESCE(string_agg(...), '') ou COALESCE(array_agg(...), '{}').

Agréger seulement certaines lignes avec FILTER

FILTER (WHERE ...) limite un agrégat aux lignes qui correspondent, tandis que le reste de la requête les voit toutes :

IT compte 3 personnes et liste Bo, Li ; Sales en compte 2 et liste Ana.

Joindre une liste à chaque ligne d'une autre table

Pour afficher chaque client avec la liste de ses produits, agrégez dans une sous-requête : la requête externe n'a alors pas besoin 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;

Les clients sans commande restent dans le résultat, avec products à NULL. Une jointure avec GROUP BY ne les garde que si c'est un LEFT JOIN.

Erreurs fréquentes et variantes

  • Nombres : string_agg prend du texte, donc string_agg(id, ',') échoue avec "function string_agg(integer, unknown) does not exist". Convertissez : string_agg(id::text, ',').
  • N premiers par groupe : découpez le tableau trié, (array_agg(name ORDER BY salary DESC))[1:2].
  • Sortie JSON : json_agg et jsonb_agg rassemblent des lignes dans un tableau JSON, et jsonb_object_agg(key, value) construit un objet ; voir JSONB.
  • Vous avez déjà un tableau : array_to_string(arr, ', ') concatène un tableau existant, et unnest le retransforme en lignes (tableaux).
  • Version window function : les deux fonctionnent aussi comme window functions, par exemple string_agg(name, ', ') OVER (PARTITION BY dept) pour afficher la liste complète sur chaque ligne.

Questions fréquentes

Quel est l'équivalent de GROUP_CONCAT dans PostgreSQL ?

string_agg(column, ','). Contrairement au GROUP_CONCAT de MySQL, le séparateur est obligatoire, et le tri se place dans l'appel : string_agg(name, ', ' ORDER BY name).

Comment utiliser string_agg avec des nombres ?

Convertissez la valeur en texte : string_agg(id::text, ','). string_agg n'accepte que du texte (ou du bytea), donc un argument entier échoue avec "function string_agg(integer, unknown) does not exist".

string_agg a-t-il une limite de longueur ?

Pas de limite propre ; le résultat est une valeur text normale, qui peut contenir jusqu'à 1 Go. Le GROUP_CONCAT de MySQL tronque à group_concat_max_len, mais PostgreSQL ne tronque pas.

Comment obtenir les N premières valeurs avec array_agg ?

Triez dans l'agrégat et découpez le résultat : (array_agg(name ORDER BY score DESC))[1:3] renvoie les trois premiers noms de chaque groupe.

Illustration des langages de programmation de Coddy

Apprendre à coder avec Coddy

Commencer