# GROUP_CONCAT

> الدالة التجميعية GROUP_CONCAT في StackQL: دمج القيم غير NULL لعمود أو مجموعة في سلسلة نصية واحدة مع فاصل اختياري.

Source: https://stackql.io/ar/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).
