> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Crea un array con una muestra de los valores del argumento. El tamaño del array resultante está limitado a `max_size` elementos. Los valores del argumento se seleccionan y se añaden al array de forma aleatoria.

# groupArraySample

## groupArraySample

Introducido en: v20.3.0

Crea un array con una muestra de los valores del argumento.
El tamaño del array resultante está limitado a `max_size` elementos.
Los valores del argumento se seleccionan y se añaden al array de forma aleatoria.

**Sintaxis**

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

**Parámetros**

* `max_size` — Tamaño máximo del array resultante. [`UInt64`](/es/reference/data-types/int-uint)
* `seed` — Opcional. Semilla para el generador de números aleatorios. Si se omite, cada estado de agregación se inicializa con una semilla obtenida de un generador local del thread, por lo que la muestra es diferente en cada evaluación y la función es no determinista. Pase una semilla para obtener una muestra reproducible. [`UInt64`](/es/reference/data-types/int-uint)
* `x` — Argumento (nombre de columna o expresión). [`Any`](/es/reference/data-types/index)

**Argumentos**

* `array_column` — Columna que contiene arrays que se agregarán. [`Array`](/es/reference/data-types/array)

**Valor devuelto**

Array con argumentos `x` seleccionados aleatoriamente. [`Array(T)`](/es/reference/data-types/array)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
CREATE TABLE colors (
    id Int32,
    color String
) ENGINE = Memory;

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

SELECT groupArraySample(3)(color) as newcolors FROM colors;
```

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

**Ejemplo con una semilla**

```sql title=Query theme={null}
-- Query with column name and different seed
SELECT groupArraySample(3, 987654321)(color) as newcolors FROM colors;
```

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

**Uso de una expresión como argumento**

```sql title=Query theme={null}
-- Query with expression as argument
SELECT groupArraySample(3)(concat('light-', color)) as newcolors FROM colors;
```

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