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

> Crée un tableau de valeurs d'arguments. Les valeurs peuvent être ajoutées au tableau dans un ordre quelconque (indéterminé).

# groupArray

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

Introduit dans : v1.1.0

Crée un tableau de valeurs d'argument.
Les valeurs peuvent être ajoutées au tableau dans un ordre quelconque (indéterminé).

La deuxième version (avec le paramètre `max_size`) limite la taille du tableau résultant à `max_size` éléments. Par exemple, `groupArray(1)(x)` est équivalent à `[any(x)]`.

Dans certains cas, vous pouvez néanmoins vous fier à l'ordre d'exécution. Cela s'applique lorsque `SELECT` provient d'une sous-requête qui utilise `ORDER BY`, si le résultat de la sous-requête est suffisamment petit.

La fonction `groupArray` supprime les valeurs `NULL` du résultat.

**Syntaxe**

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

**Alias** : `array_agg`

**Paramètres**

* `max_size` — Facultatif. Limite la taille du tableau résultant à `max_size` éléments. [`UInt64`](/fr/reference/data-types/int-uint)

**Arguments**

* `x` — Valeurs d’argument à regrouper dans un tableau. [`Any`](/fr/reference/data-types/index)

**Valeur renvoyée**

Renvoie un tableau contenant les valeurs d’argument. [`Array`](/fr/reference/data-types/array)

**Exemples**

**Utilisation de base**

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