> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.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>
  إذا تم تحديد الفاصل بدون limit، فيجب أن يكون هو المَعلَمة الأولى. وإذا تم تحديد كلٍّ من الفاصل وlimit، فيجب أن يسبق الفاصل limit.

  كذلك، إذا تم تحديد فواصل مختلفة كمَعلَمات ووسائط، فسيُستخدم فقط الفاصل المحدد في الوسائط.
</Note>

**الصيغة**

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

**الأسماء البديلة**: `group_concat`, `string_agg`

**المعلمات**

* `delimiter` — سلسلة نصية تُستخدم للفصل بين القيم المتسلسلة. هذه المعلمة اختيارية، وتكون قيمتها الافتراضية سلسلة نصية فارغة إذا لم يتم تحديدها. [`String`](/ar/reference/data-types/string)
* `limit` — عدد صحيح موجب يحدد الحد الأقصى لعدد العناصر المراد تسلسلها. إذا وُجدت عناصر أكثر، فسيتم تجاهل العناصر الزائدة. هذه المعلمة اختيارية. [`UInt*`](/ar/reference/data-types/int-uint)

**الوسائط**

* `expression` — التعبير أو اسم العمود الذي ينتج السلاسل النصية المراد تسلسلها. [`String`](/ar/reference/data-types/string)
* `delimiter` — سلسلة نصية تُستخدم للفصل بين القيم المتسلسلة. هذه الوسيطة اختيارية، وتكون قيمتها الافتراضية سلسلة نصية فارغة أو الفاصل المحدد في المعلمات إذا لم يتم تحديدها. [`String`](/ar/reference/data-types/string)

**القيمة المُعادة**

تعيد سلسلة نصية تتكون من القيم المتسلسلة للعمود أو التعبير. إذا لم تحتوِ المجموعة على أي عناصر، أو كانت تحتوي فقط على عناصر NULL، ولم تحدد الدالة طريقة للتعامل مع القيم التي تكون كلها NULL، فستكون النتيجة سلسلة نصية قابلة لأن تكون NULL وقيمتها NULL. [`String`](/ar/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
```