> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ينشئ مصفوفة من قيم الوسيطات المأخوذة كعينة. يقتصر حجم المصفوفة الناتجة على `max_size` عنصرًا. تُختار قيم الوسيطات وتُضاف إلى المصفوفة عشوائيًا.

# groupArraySample

## groupArraySample

قُدِّمت في: v20.3.0

ينشئ مصفوفة من قيم الوسيطات المأخوذة كعينة.
يُقتصر حجم المصفوفة الناتجة على `max_size` عنصرًا.
تُختار قيم الوسيطات وتُضاف إلى المصفوفة عشوائيًا.

**الصيغة**

```sql theme={null}
groupArraySample(max_size[, seed])(x)
```

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

* `max_size` — الحد الأقصى لحجم المصفوفة الناتجة. [`UInt64`](/ar/reference/data-types/int-uint)
* `seed` — اختياري. قيمة البذرة لمولّد الأرقام العشوائية. عند حذفها، تستمد كل حالة تجميع بذرتها من مولّد خاص بخيط التنفيذ، لذا تختلف العينة في كل تقييم وتكون الدالة غير حتمية. مرّر قيمة seed للحصول على عينة قابلة لإعادة الإنتاج. [`UInt64`](/ar/reference/data-types/int-uint)
* `x` — وسيطة (اسم العمود أو تعبير). [`Any`](/ar/reference/data-types/index)

**الوسائط**

* `array_column` — عمود يحتوي على مصفوفات ليتم تجميعها. [`Array`](/ar/reference/data-types/array)

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

مصفوفة من قيم x المختارة عشوائيًا. [`Array(T)`](/ar/reference/data-types/array)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
CREATE TABLE colors (
    id Int32,
    color String
) ENGINE = Memory;

INSERT INTO colors VALUES
(1, 'red'),
(2, 'blue'),
(3, 'green'),
(4, 'white'),
(5, 'orange');

SELECT groupArraySample(3)(color) as newcolors FROM colors;
```

```response title=Response theme={null}
┌─newcolors──────────────────┐
│ ['white','blue','green']   │
└────────────────────────────┘
```

**مثال باستخدام قيمة seed**

```sql title=Query theme={null}
-- Query with column name and different seed
SELECT groupArraySample(3, 987654321)(color) as newcolors FROM colors;
```

```response title=Response theme={null}
┌─newcolors────────────────┐
│ ['red','orange','green'] │
└──────────────────────────┘
```

**استخدام تعبير بوصفه وسيطة**

```sql title=Query theme={null}
-- Query with expression as argument
SELECT groupArraySample(3)(concat('light-', color)) as newcolors FROM colors;
```

```response title=Response theme={null}
┌─newcolors───────────────────────────────────┐
│ ['light-blue','light-orange','light-green'] │
└─────────────────────────────────────────────┘
```