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

> Вычисляет конкатенированную строку из группы строк, при необходимости разделённых разделителем, с возможностью ограничения максимального количества элементов.

# groupConcat

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

Добавленный в: v24.8.0

Вычисляет конкатенированную строку из группы строк, при необходимости разделённых разделителем, и при необходимости ограничивает число элементов.

<Note>
  Если разделитель указан без ограничения, он должен быть первым параметром. Если указаны и разделитель, и ограничение, разделитель должен предшествовать ограничению.

  Также, если в параметрах и аргументах указаны разные разделители, будет использоваться только разделитель из аргументов.
</Note>

**Синтаксис**

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

**Псевдонимы**: `group_concat`

**Параметры**

* `delimiter` — строка, используемая для разделения объединённых значений. Этот параметр необязателен; если он не указан, по умолчанию используется пустая строка. [`String`](/ru/reference/data-types/string)
* `limit` — положительное целое число, задающее максимальное количество объединяемых элементов. Если элементов больше, лишние игнорируются. Этот параметр необязателен. [`UInt*`](/ru/reference/data-types/int-uint)

**Аргументы**

* `expression` — выражение или имя столбца, возвращающее строки для объединения. [`String`](/ru/reference/data-types/string)
* `delimiter` — строка, используемая для разделения объединённых значений. Этот аргумент необязателен; если он не указан, по умолчанию используется пустая строка или разделитель из параметров. [`String`](/ru/reference/data-types/string)

**Возвращаемое значение**

Возвращает строку, состоящую из объединённых значений столбца или выражения. Если в группе нет элементов либо есть только элементы со значением NULL, и функция не задаёт обработку случая, когда присутствуют только значения NULL, результатом будет строка Nullable со значением NULL. [`String`](/ru/reference/data-types/string)

**Примеры**

**Базовое использование без разделителя**

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

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

**Использование запятой как разделителя (синтаксис параметра)**

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

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

**Использование запятой как разделителя (синтаксис аргумента)**

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

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

**Ограничение числа объединяемых элементов**

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

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