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

> 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

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

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. Valor predeterminado: 123456. [`UInt64`](/es/reference/data-types/int-uint)
* `x` — Argumento (nombre de columna o expresión). [`Any`](/es/reference/data-types)

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

**Ejemplo con una semilla**

```sql title=Query theme={null}
-- Consulta con nombre de columna y semilla diferente
SELECT groupArraySample(3, 987654321)(color) as newcolors FROM default.colors;
```

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

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

```sql title=Query theme={null}
-- Consulta con una expresión 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'] │
└─────────────────────────────────────────────┘
```