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

> Inserta un valor en el array en la posición indicada.

# groupArrayInsertAt

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

Introducido en: v1.1.0

Inserta un valor en el array en la posición especificada.

Si en una consulta se insertan varios valores en la misma posición, la función se comporta del siguiente modo:

* Si una consulta se ejecuta en un solo hilo, se usa el primero de los valores insertados.
* Si una consulta se ejecuta en varios hilos, el valor resultante es uno indeterminado entre los valores insertados.

**Sintaxis**

```sql theme={null}
groupArrayInsertAt(default_x, size)([x, pos])
```

**Parámetros**

* `default_x` — Opcional. Valor predeterminado para sustituir las posiciones vacías. [`Any`](/es/reference/data-types)
* `size` — Opcional. Longitud del array resultante. Al usar este parámetro, se debe especificar el valor predeterminado `default_x`. [`UInt32`](/es/reference/data-types/int-uint)

**Argumentos**

* `x` — Valor que se va a insertar. [`Any`](/es/reference/data-types)
* `pos` — Posición en la que se insertará el elemento `x` especificado. La numeración de los índices del array comienza en cero. [`UInt32`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve un array con los valores insertados. [`Array`](/es/reference/data-types/array)

**Ejemplos**

**Uso básico sin parámetros**

```sql title=Query theme={null}
SELECT groupArrayInsertAt(toString(number), number * 2) FROM numbers(5);
```

```response title=Response theme={null}
┌─groupArrayInsertAt(toString(number), multiply(number, 2))─┐
│ ['0','','1','','2','','3','','4']                         │
└───────────────────────────────────────────────────────────┘
```

**Uso del parámetro de valor predeterminado**

```sql title=Query theme={null}
SELECT groupArrayInsertAt('-')(toString(number), number * 2) FROM numbers(5);
```

```response title=Response theme={null}
┌─groupArrayInsertAt('-')(toString(number), multiply(number, 2))─┐
│ ['0','-','1','-','2','-','3','-','4']                          │
└────────────────────────────────────────────────────────────────┘
```

**Uso con los parámetros de valor predeterminado y tamaño**

```sql title=Query theme={null}
SELECT groupArrayInsertAt('-', 5)(toString(number), number * 2) FROM numbers(5);
```

```response title=Response theme={null}
┌─groupArrayInsertAt('-', 5)(toString(number), multiply(number, 2))─┐
│ ['0','-','1','-','2']                                             │
└───────────────────────────────────────────────────────────────────┘
```

**Inserción desde varios hilos en la misma posición**

```sql title=Query theme={null}
SELECT groupArrayInsertAt(number, 0) FROM numbers_mt(10) SETTINGS max_block_size = 1;
```

```response title=Response theme={null}
┌─groupArrayInsertAt(number, 0)─┐
│ [7]                           │
└───────────────────────────────┘
```