기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# COLLECT\_LIST 함수
<a name="COLLECT_LIST"></a>

COLLECT\_LIST 함수는 고유하지 않은 요소 목록을 수집하고 반환합니다.

이 함수 유형은 행 집합에서 여러 값을 단일 배열로 수집하거나 데이터 구조를 나열하려는 경우에 유용합니다.

**참고**  
수집된 결과의 순서는 셔플 작업이 수행된 후 비결정적일 수 있는 행의 순서에 따라 달라지므로 함수는 비결정적입니다.

## 구문
<a name="COLLECT_LIST-syntax"></a>

```
collect_list(expr)
```

## 인수
<a name="COLLECT_LIST-arguments"></a>

 expr**   
모든 유형의 표현식입니다.

## 반환
<a name="COLLECT_LIST-returns"></a>

인수 유형의 ARRAY를 반환합니다. 배열의 요소 순서는 비결정적입니다.

NULL 값은 제외됩니다.

DISTINCT를 지정하면 함수는 고유한 값만 수집하며 `collect_set `집계 함수의 동의어입니다.

## 예제
<a name="COLLECT_LIST-example"></a>

다음 쿼리는 열의 모든 값을 목록으로 수집합니다. `VALUES` 절은 행이 3개인 인라인 테이블을 생성하는 데 사용되며, 각 행에는 각각 값이 1, 2, 1인 단일 열 열 열이 있습니다. 그런 다음 `collect_list() `함수를 사용하여 열의 모든 값을 단일 배열로 집계합니다. 이 SQL 문의 출력은 입력 데이터에 표시된 순서대로 열의 모든 값을 `[1,2,1]`포함하는 배열입니다.

```
SELECT collect_list(col) FROM VALUES (1), (2), (1) AS tab(col);
 [1,2,1]
```