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

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

# groupArraySample

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

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

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

**الصيغة**

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

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

* `max_size` — الحد الأقصى لحجم المصفوفة الناتجة. [`UInt64`](/ar/reference/data-types/int-uint)
* `seed` — اختياري. قيمة البذرة لمولّد الأرقام العشوائية. القيمة الافتراضية: 123456. [`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 default.colors (
    id Int32,
    color String
) ENGINE = Memory;

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

SELECT groupArraySample(3)(color) as newcolors FROM default.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 default.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 default.colors;
```

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