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

> Cria um array de valores de argumentos. Os valores podem ser adicionados ao array em qualquer ordem (indeterminada).

# groupArray

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

Introduzido em: v1.1.0

Cria um array de valores de argumentos.
Os valores podem ser adicionados ao array em qualquer ordem (indeterminada).

A segunda versão (com o parâmetro `max_size`) limita o tamanho do array resultante a `max_size` elementos. Por exemplo, `groupArray(1)(x)` é equivalente a `[any(x)]`.

Em alguns casos, ainda é possível contar com a ordem de execução. Isso se aplica quando o `SELECT` vem de uma subconsulta que usa `ORDER BY`, se o resultado da subconsulta for pequeno o suficiente.

A função `groupArray` remove os valores `NULL` do resultado.

**Sintaxe**

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

**Aliases**: `array_agg`

**Parâmetros**

* `max_size` — Opcional. Limita o tamanho do array resultante a `max_size` elementos. [`UInt64`](/pt-BR/reference/data-types/int-uint)

**Argumentos**

* `x` — Valores do argumento a serem coletados em um array. [`Any`](/pt-BR/reference/data-types/index)

**Valor retornado**

Retorna um array de valores de argumentos. [`Array`](/pt-BR/reference/data-types/array)

**Exemplos**

**Uso básico**

```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']           │
└────┴──────────────────────┘
```