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

> 인수 값의 배열을 생성합니다. 값은 정해지지 않은 임의의 순서로 배열에 추가될 수 있습니다.

# groupArray

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

도입 버전: v1.1.0

인수 값의 배열을 생성합니다.
값은 배열에 임의의(비결정적) 순서로 추가될 수 있습니다.

두 번째 버전(`max_size` 매개변수가 있는 버전)은 결과 배열의 크기를 `max_size`개 요소로 제한합니다. 예를 들어, `groupArray(1)(x)`는 `[any(x)]`와 같습니다.

경우에 따라서는 실행 순서를 신뢰할 수 있습니다. 이는 `SELECT`가 `ORDER BY`를 사용하는 서브쿼리(subquery)에서 오고, 서브쿼리 결과가 충분히 작은 경우에 적용됩니다.

`groupArray` 함수는 결과에서 `NULL` 값을 제거합니다.

**구문**

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

**별칭**: `array_agg`

**매개변수**

* `max_size` — 선택 사항입니다. 결과 배열을 최대 `max_size`개 요소로 제한합니다. [`UInt64`](/ko/reference/data-types/int-uint)

**인수**

* `x` — 배열로 수집할 인수 값입니다. [`Any`](/ko/reference/data-types)

**반환 값**

인수 값을 담은 배열을 반환합니다. [`Array`](/ko/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']           │
└────┴──────────────────────┘
```