Skip to main content
이러한 설정은 system.merge_tree_settings에서 확인할 수 있으며, ClickHouse 소스 코드에서 자동 생성됩니다.

map_buckets_coefficient

평균 맵 크기에서 버킷 수를 계산할 때 sqrtlinear map_buckets_strategy에서 사용하는 계수입니다. sqrt 전략의 경우: round(map_buckets_coefficient * sqrt(avg_map_size)). linear 전략의 경우: round(map_buckets_coefficient * avg_map_size). map_buckets_strategyconstant이면 이 설정은 무시됩니다.

map_buckets_min_avg_size

with_buckets 직렬화를 적용하는 데 필요한 최소 평균 맵 크기(행당 키 수)입니다. 평균 맵 크기가 이 값보다 작으면 다른 버킷 설정과 관계없이 단일 버킷이 사용됩니다. 값이 0이면 임계값이 비활성화되며 버킷화 전략이 항상 적용됩니다. 이 설정은 효과가 거의 없는 작은 맵에 버킷 직렬화를 적용할 때 발생하는 오버헤드를 줄이는 데 유용합니다.

map_buckets_strategy

평균 맵 크기를 기준으로 with_buckets Map 직렬화에서 버킷 수를 선택하는 전략을 제어합니다. 가능한 값:
  • constant — 평균 맵 크기와 관계없이 항상 max_buckets_in_map을 버킷 수로 사용합니다.
  • sqrt — 버킷 수로 round(map_buckets_coefficient * sqrt(avg_map_size))를 사용하며, 값은 [1, max_buckets_in_map] 범위로 제한됩니다.
  • linear — 버킷 수로 round(map_buckets_coefficient * avg_map_size)를 사용하며, 값은 [1, max_buckets_in_map] 범위로 제한됩니다.
마지막 수정일 2026년 7월 23일