groupConcat

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

​

groupConcat

Introduit dans : v24.8.0

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

Si délimiteur est spécifié sans limit, il doit s’agir du premier paramètre. Si délimiteur et limit sont tous deux spécifiés, délimiteur doit précéder limit.

De plus, si des délimiteurs différents sont spécifiés comme paramètres et arguments, seul le délimiteur des arguments sera utilisé.

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

Query

SELECT groupConcat(Name) FROM Employees;

Response

JohnJaneBob

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

Query

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

Response

John, Jane, Bob

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

Query

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

Response

John, Jane, Bob

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

Query

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

Response

John, Jane