Skip to main content
이 설정은 system.settings에서 사용할 수 있으며 source로부터 자동 생성됩니다.

​
group_by_overflow_mode

집계 시 고유 키 수가 한도를 초과하면 어떻게 처리할지 설정합니다.
  • throw: 예외를 발생시킵니다
  • break: 쿼리 실행을 중지하고 부분 결과를 반환합니다
  • any: Set에 포함된 키에 대해서는 집계를 계속하지만, 새로운 키는 Set에 추가하지 않습니다.
any 값을 사용하면 GROUP BY의 근사치를 계산할 수 있습니다. 이 근사의 품질은 데이터의 통계적 특성에 따라 달라집니다.

​
group_by_two_level_threshold

키 개수가 이 수에 도달하면 2단계 집계가 시작됩니다. 0이면 임계값이 설정되지 않습니다.

​
group_by_two_level_threshold_bytes

집계 상태의 크기가 몇 바이트부터 2단계 집계를 사용하기 시작할지 지정합니다. 0은 임계값이 설정되지 않았음을 의미합니다. 임계값 중 하나 이상이 충족되면 2단계 집계가 사용됩니다.

​
group_by_use_nulls

GROUP BY 절이 집계 키의 타입을 처리하는 방식을 변경합니다. ROLLUP, CUBE, 또는 GROUPING SETS 지정자를 사용하면 일부 집계 키가 일부 결과 행을 생성하는 데 사용되지 않을 수 있습니다. 이러한 키의 컬럼은 이 설정에 따라 해당 행에서 기본값 또는 NULL로 채워집니다. Possible values:
  • 0 — 누락된 값을 생성할 때 집계 키 타입의 기본값을 사용합니다.
  • 1 — ClickHouse는 SQL 표준에 정의된 방식과 동일하게 GROUP BY를 실행합니다. 집계 키의 타입은 널 허용으로 변환됩니다. 해당 집계 키의 컬럼은 이 키가 사용되지 않은 행에서 NULL로 채워집니다.
관련 항목:
마지막 수정일 2026년 7월 23일