> ## 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.

> ينشئ مصفوفة من قيم الوسائط. ويمكن إضافة القيم إلى المصفوفة بأي ترتيب (غير محدد).

# groupArray

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

قُدِّم في: v1.1.0

ينشئ مصفوفة من قيم الوسائط.
يمكن إضافة القيم إلى المصفوفة بأي ترتيب (غير محدد).

يقيّد الإصدار الثاني (باستخدام المعلَمة `max_size`) حجم المصفوفة الناتجة إلى `max_size` عنصرًا. على سبيل المثال، فإن `groupArray(1)(x)` مكافئ لـ `[any(x)]`.

في بعض الحالات، لا يزال بإمكانك الاعتماد على ترتيب التنفيذ. وينطبق ذلك عندما تأتي `SELECT` من استعلام فرعي يستخدم `ORDER BY`، إذا كانت نتيجة الاستعلام الفرعي صغيرة بما يكفي.

تزيل الدالة `groupArray` قيم `NULL` من النتيجة.

**البنية**

```sql theme={null}
groupArray(x)
groupArray(max_size)(x)
```

**الأسماء البديلة**: `array_agg`

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

* `max_size` — اختياري. يحدّ حجم المصفوفة الناتجة إلى `max_size` من العناصر. [`UInt64`](/ar/reference/data-types/int-uint)

**الوسيطات**

* `x` — قيم الوسيطات المراد تجميعها في مصفوفة. [`Any`](/ar/reference/data-types/index)

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

يعيد مصفوفة من قيم الوسيطات. [`Array`](/ar/reference/data-types/array)

**أمثلة**

**الاستخدام الأساسي**

```sql title=Query theme={null}
SELECT id, groupArray(10)(name) FROM default.ck GROUP BY id;
```

```response title=Response theme={null}
┌─id─┬─groupArray(10)(name)─┐
│  1 │ ['zhangsan','lisi']  │
│  2 │ ['wangwu']           │
└────┴──────────────────────┘
```