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

> argument の値で構成される Array を作成します。値は任意の（不定の）順序で Array に追加される場合があります。

# groupArray

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

導入バージョン: v1.1.0

引数の値からArrayを作成します。
値は任意の (不定な) 順序でArrayに追加されます。

2 番目のバージョン (`max_size` パラメータ付き) は、結果のArrayのサイズを `max_size` 要素に制限します。たとえば、`groupArray(1)(x)` は `[any(x)]` と同等です。

場合によっては、実行順序に依存できることもあります。これは、`SELECT` の対象が `ORDER BY` を使用するサブクエリであり、そのサブクエリの結果が十分に小さい場合に当てはまります。

`groupArray` 関数は、結果から `NULL` 値を削除します。

**構文**

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

**別名**: `array_agg`

**パラメータ**

* `max_size` — 任意。結果のArrayの要素数を `max_size` に制限します。[`UInt64`](/ja/reference/data-types/int-uint)

**引数**

* `x` — Arrayにまとめる引数の値。[`Any`](/ja/reference/data-types)

**戻り値**

引数の値からなるArrayを返します。[`Array`](/ja/reference/data-types/array)

**例**

**基本的な使い方**

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