> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.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`](/ru/reference/data-types/int-uint)
* `seed` — Необязательно. Значение seed для генератора случайных чисел. Значение по умолчанию: 123456. [`UInt64`](/ru/reference/data-types/int-uint)
* `x` — Аргумент (имя столбца или выражение). [`Any`](/ru/reference/data-types)

**Аргументы**

* `array_column` — Столбец, содержащий массивы для агрегирования. [`Array`](/ru/reference/data-types/array)

**Возвращаемое значение**

Массив аргументов `x`, выбранных случайным образом. [`Array(T)`](/ru/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}
-- Запрос с именем столбца и другим 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}
-- Запрос с выражением в качестве аргумента
SELECT groupArraySample(3)(concat('light-', color)) as newcolors FROM default.colors;
```

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