array_agg 집계 함수

  • 아티클

적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 10.4 LTS 이상

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

구문

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

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

인수

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

반품

인수 형식의 ARRAY입니다.

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

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

예제

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