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

> Cria um array com uma amostra dos valores do argumento. O tamanho do array resultante é limitado a `max_size` elementos. Os valores do argumento são selecionados aleatoriamente e adicionados ao array.

# groupArraySample

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

Introduzido na versão: v20.3.0

Cria um array com valores de argumento de amostra.
O tamanho do array resultante é limitado a `max_size` elementos.
Os valores dos argumentos são selecionados e adicionados ao array aleatoriamente.

**Sintaxe**

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

**Parâmetros**

* `max_size` — Tamanho máximo do array resultante. [`UInt64`](/pt-BR/reference/data-types/int-uint)
* `seed` — Opcional. Semente para o gerador de números aleatórios. Valor padrão: 123456. [`UInt64`](/pt-BR/reference/data-types/int-uint)
* `x` — Argumento (nome da coluna ou expressão). [`Any`](/pt-BR/reference/data-types)

**Argumentos**

* `array_column` — Coluna que contém arrays a serem agregados. [`Array`](/pt-BR/reference/data-types/array)

**Valor retornado**

Array de argumentos `x` selecionados aleatoriamente. [`Array(T)`](/pt-BR/reference/data-types/array)

**Exemplos**

**Exemplo de uso**

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

**Exemplo com seed**

```sql title=Query theme={null}
-- Consulta com nome de coluna e seed diferente
SELECT groupArraySample(3, 987654321)(color) as newcolors FROM default.colors;
```

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

**Usando uma expressão como argumento**

```sql title=Query theme={null}
-- Consulta com expressão como argumento
SELECT groupArraySample(3)(concat('light-', color)) as newcolors FROM default.colors;
```

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