groupConcat

Introduit dans : v24.8.0

Calcule une chaîne concaténée à partir d’un groupe de chaînes, éventuellement séparées par un délimiteur, et éventuellement limitée à un nombre maximal d’éléments.

Syntaxe

groupConcat[(delimiter [, limit])](expression)

Alias : group_concat, string_agg

Paramètres

• delimiter — Chaîne utilisée pour séparer les valeurs concaténées. Ce paramètre est facultatif et, s’il n’est pas spécifié, sa valeur par défaut est une chaîne vide. String
• limit — Entier positif indiquant le nombre maximal d’éléments à concaténer. Si davantage d’éléments sont présents, les éléments excédentaires sont ignorés. Ce paramètre est facultatif. UInt*

Arguments

• expression — Expression ou nom de colonne produisant les chaînes à concaténer. String
• delimiter — Chaîne utilisée pour séparer les valeurs concaténées. Ce paramètre est facultatif et, s’il n’est pas spécifié, sa valeur par défaut est une chaîne vide ou le délimiteur défini dans les paramètres. String

Valeur renvoyée

Renvoie une chaîne constituée des valeurs concaténées de la colonne ou de l’expression. Si le groupe ne contient aucun élément, ou uniquement des éléments NULL, et que la fonction ne spécifie pas de traitement pour les valeurs uniquement NULL, le résultat est une chaîne nullable avec une valeur NULL. String

Exemples

Utilisation de base sans délimiteur

CREATE TABLE Employees (Name String) ENGINE = Memory;
INSERT INTO Employees VALUES ('John'), ('Jane'), ('Bob');

SELECT groupConcat(Name) FROM Employees;

JohnJaneBob

Utilisation de la virgule comme délimiteur (syntaxe des paramètres)

SELECT groupConcat(', ')(Name) FROM Employees;

John, Jane, Bob

Utilisation de la virgule comme délimiteur (syntaxe de l’argument)

SELECT groupConcat(Name, ', ') FROM Employees;

John, Jane, Bob

Limiter le nombre d’éléments concaténés

SELECT groupConcat(', ', 2)(Name) FROM Employees;

John, Jane