> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/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 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.

<Note>
  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é.
</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`](/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*`](/fr/reference/data-types/int-uint)

**Arguments**

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