groupConcat

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

​

groupConcat

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

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

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

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

Синтаксис

groupConcat[(delimiter [, limit])](expression)

Псевдонимы: group_concat, string_agg

Параметры

• delimiter — строка, используемая для разделения объединённых значений. Этот параметр необязателен; если он не указан, по умолчанию используется пустая строка. String
• limit — положительное целое число, задающее максимальное количество объединяемых элементов. Если элементов больше, лишние игнорируются. Этот параметр необязателен. UInt*

Аргументы

• expression — выражение или имя столбца, возвращающее строки для объединения. String
• delimiter — строка, используемая для разделения объединённых значений. Этот аргумент необязателен; если он не указан, по умолчанию используется пустая строка или разделитель из параметров. String

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

Возвращает строку, состоящую из объединённых значений столбца или выражения. Если в группе нет элементов либо есть только элементы со значением NULL, и функция не задаёт обработку случая, когда присутствуют только значения NULL, результатом будет строка Nullable со значением NULL. String

Примеры

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

Query

SELECT groupConcat(Name) FROM Employees;

Response

JohnJaneBob

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

Query

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

Response

John, Jane, Bob

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

Query

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

Response

John, Jane, Bob

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

Query

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

Response

John, Jane