collect_list 집계 함수

적용 대상:검사 예 Databricks SQL 검사 예 Databricks Runtime으로 표시됨

그룹 내의 모든 값 expr 으로 구성된 배열을 반환합니다. 이 함수는 array_agg 집계 함수의 동의어입니다.

구문

collect_list ( [ALL | DISTINCT] expr ) [FILTER ( WHERE cond ) ]

이 함수는 절을 사용하여 OVER창 함수로 호출할 수도 있습니다.

인수

  • expr: 모든 형식의 식입니다.
  • cond: 집계에 사용되는 행을 필터링하는 선택적 부울 식입니다.

반환

인수 형식의 ARRAY입니다.

배열의 요소 순서는 비결정적입니다. NULL 값은 제외됩니다.

가 지정된 경우 DISTINCT 함수는 고유 값만 수집하고 collect_set 집계 함수의 동의어입니다.

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

> SELECT collect_list(DISTINCT col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
 [1,2]