# GROUP_CONCAT

> Агрегатна функція GROUP_CONCAT у StackQL: конкатенація відмінних від NULL значень стовпця або групування в один рядок із необов'язковим роздільником.

Source: https://stackql.io/uk/language-spec/functions/aggregate/group_concat

Повертає рядкове значення, що є конкатенацією всіх відмінних від `NULL` значень вхідного стовпця або групування.  

> Порядок конкатенованих елементів довільний.

Див. також:  
[[` SELECT `]](/language-spec/select)

* * * 

## Синтаксис

```sql
SELECT GROUP_CONCAT(columnExpression [, separator]) FROM <multipartIdentifier>
[ GROUP BY groupByColumn ];
```

## Аргументи

__*columnExpression*__  
Стовпець або вираз.  

> Принаймні одне значення *columnExpression* має бути відмінним від `NULL`, інакше повертається `NULL`.

__*separator*__  
Роздільник для результату конкатенації; якщо *separator* не вказано, використовується значення за замовчуванням `,`.

__*groupByColumn*__  
Стовпець або стовпці, за якими виконуються підсумкові чи агрегатні операції.  Речення `GROUP BY` повертає один рядок для кожного групування стовпців.

## Значення, що повертається

Повертає рядкове значення у вигляді списку значень, розділених роздільником *separator* або `,`.

* * *

## Приклади

### Отримання списку значень стовпця для всього ресурсу

```sql
SELECT group_concat(name) as instance_list
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';
```

### Отримання списку значень виразу стовпця, згрупованих за іншим виразом стовпця

```sql
SELECT SPLIT_PART(machineType, '/', -1) as machine_type, group_concat(name) as instance_list
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a'
GROUP BY SPLIT_PART(machineType, '/', -1);
```

Докладніше див. [https://www.sqlite.org/lang_aggfunc.html#group_concat](https://www.sqlite.org/lang_aggfunc.html#group_concat).
