> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> 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

<div id="groupConcat">
  ## groupConcat
</div>

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.

<Note>
  Si `delimiter` est spécifié sans `limit`, il doit s’agir du premier paramètre. Si `delimiter` et `limit` sont tous deux spécifiés, `delimiter` 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é.
</Note>

**Syntaxe**

```sql theme={null}
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`](/docs/fr/reference/data-types/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*`](/docs/fr/reference/data-types/int-uint)

**Arguments**

* `expression` — Expression ou nom de colonne produisant les chaînes à concaténer. [`String`](/docs/fr/reference/data-types/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`](/docs/fr/reference/data-types/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`](/docs/fr/reference/data-types/string)

**Exemples**

**Utilisation de base sans délimiteur**

```sql title=Query theme={null}
SELECT groupConcat(Name) FROM Employees;
```

```response title=Response theme={null}
JohnJaneBob
```

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

```sql title=Query theme={null}
SELECT groupConcat(', ')(Name) FROM Employees;
```

```response title=Response theme={null}
John, Jane, Bob
```

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

```sql title=Query theme={null}
SELECT groupConcat(Name, ', ') FROM Employees;
```

```response title=Response theme={null}
John, Jane, Bob
```

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

```sql title=Query theme={null}
SELECT groupConcat(', ', 2)(Name) FROM Employees;
```

```response title=Response theme={null}
John, Jane
```