> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.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`](/ru/reference/data-types/int-uint)

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

* `x` — Значения аргумента, собираемые в массив. [`Any`](/ru/reference/data-types)

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

Возвращает массив значений аргумента. [`Array`](/ru/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']           │
└────┴──────────────────────┘
```