메인 콘텐츠로 건너뛰기

groupArray

도입 버전: v1.1.0 인수 값의 배열을 생성합니다. 값은 배열에 임의의(비결정적) 순서로 추가될 수 있습니다. 두 번째 버전(max_size 매개변수가 있는 버전)은 결과 배열의 크기를 max_size개 요소로 제한합니다. 예를 들어, groupArray(1)(x)[any(x)]와 같습니다. 경우에 따라서는 실행 순서를 신뢰할 수 있습니다. 이는 SELECTORDER BY를 사용하는 서브쿼리(subquery)에서 오고, 서브쿼리 결과가 충분히 작은 경우에 적용됩니다. groupArray 함수는 결과에서 NULL 값을 제거합니다. 구문
groupArray(x)
groupArray(max_size)(x)
별칭: array_agg 매개변수
  • max_size — 선택 사항입니다. 결과 배열을 최대 max_size개 요소로 제한합니다. UInt64
인수
  • x — 배열로 수집할 인수 값입니다. Any
반환 값 인수 값을 담은 배열을 반환합니다. Array 예시 기본 사용법
Query
SELECT id, groupArray(10)(name) FROM default.ck GROUP BY id;
Response
┌─id─┬─groupArray(10)(name)─┐
│  1 │ ['zhangsan','lisi']  │
│  2 │ ['wangwu']           │
└────┴──────────────────────┘
마지막 수정일 2026년 6월 10일