> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Calcula uma string concatenada a partir de um grupo de strings, opcionalmente separadas por um delimitador e, também opcionalmente, limitadas a um número máximo de elementos.

# groupConcat

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

Introduzido em: v24.8.0

Calcula uma string concatenada a partir de um grupo de strings, opcionalmente separadas por um delimitador e, opcionalmente, limitada a um número máximo de elementos.

<Note>
  Se `delimiter` for especificado sem `limit`, ele deverá ser o primeiro parâmetro. Se tanto `delimiter` quanto `limit` forem especificados, `delimiter` deverá vir antes de `limit`.

  Além disso, se delimitadores diferentes forem especificados como parâmetros e argumentos, apenas o delimitador dos argumentos será usado.
</Note>

**Sintaxe**

```sql theme={null}
groupConcat[(delimiter [, limit])](expression)
```

**Aliases**: `group_concat`

**Parâmetros**

* `delimiter` — Uma string usada para separar os valores concatenados. Este parâmetro é opcional e, se não for especificado, o valor padrão será uma string vazia. [`String`](/pt-BR/reference/data-types/string)
* `limit` — Um inteiro positivo que especifica o número máximo de elementos a concatenar. Se houver mais elementos, os excedentes serão ignorados. Este parâmetro é opcional. [`UInt*`](/pt-BR/reference/data-types/int-uint)

**Argumentos**

* `expression` — A expressão ou o nome da coluna que gera as strings a serem concatenadas. [`String`](/pt-BR/reference/data-types/string)
* `delimiter` — Uma string usada para separar os valores concatenados. Este parâmetro é opcional e, se não for especificado, o valor padrão será uma string vazia ou o delimitador definido nos parâmetros. [`String`](/pt-BR/reference/data-types/string)

**Valor retornado**

Retorna uma string composta pelos valores concatenados da coluna ou expressão. Se o grupo não tiver elementos ou tiver apenas elementos nulos, e a função não especificar um tratamento para casos com apenas valores nulos, o resultado será uma string Nullable com valor NULL. [`String`](/pt-BR/reference/data-types/string)

**Exemplos**

**Uso básico sem delimitador**

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

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

**Usando a vírgula como delimitador (sintaxe do parâmetro)**

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

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

**Usando a vírgula como delimitador (sintaxe do argumento)**

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

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

**Limitando a quantidade de elementos concatenados**

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

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