Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

uniqCombined

View as MarkdownEdit this pageReport an issueSet up docs MCP

uniqCombined

도입 버전: v1.1.0

서로 다른 인수 값의 대략적인 개수를 계산합니다. 결과는 결정론적으로 반환됩니다(쿼리 처리 순서에 의존하지 않음).

uniq 함수와 비교하면 uniqCombined 함수는 다음과 같은 특징이 있습니다.

  • 메모리 사용량이 몇 배 더 적습니다
  • 정확도가 몇 배 더 높습니다
  • 일반적으로 성능은 약간 더 낮습니다. 다만 일부 시나리오에서는 uniqCombined가 uniq보다 더 나은 성능을 낼 수 있습니다. 예를 들어, 네트워크를 통해 많은 수의 집계 상태를 전송하는 분산 쿼리에서 그렇습니다
구현 세부 사항

이 함수는 집계의 모든 매개변수에 대해 해시(String에는 64비트 해시, 그 외에는 32비트)를 계산한 다음, 이를 계산에 사용합니다. 이 함수는 배열, 해시 테이블, 그리고 오차 보정 테이블이 포함된 HyperLogLog를 조합한 세 가지 알고리즘을 사용합니다:

  • 고유 원소 수가 적을 때는 배열을 사용합니다
  • 집합 크기가 더 커지면 해시 테이블을 사용합니다
  • 원소 수가 더 많아지면 HyperLogLog를 사용하며, 이 경우 고정된 양의 메모리를 사용합니다

구문

uniqCombined(HLL_precision)(x[, ...])
uniqCombined(x[, ...])

매개변수

  • HLL_precision — 선택 사항입니다. HyperLogLog의 셀 수에 대한 밑이 2인 로그입니다. 기본값은 17이며, 이는 실질적으로 96 KiB의 공간(2^17개 셀, 각 6비트)에 해당합니다. 범위: [12, 20]. UInt8

인수

반환 값

서로 다른 인수 값의 대략적인 개수를 나타내는 UInt64 타입의 숫자를 반환합니다. UInt64

예시

기본 사용법

SELECT uniqCombined(number) FROM numbers(1e6);
┌─uniqCombined(number)─┐
│              1001148 │
└──────────────────────┘

사용자 지정 정밀도

SELECT uniqCombined(15)(number) FROM numbers(1e5);
┌─uniqCombined(15)(number)─┐
│                   100768 │
└──────────────────────────┘

관련 항목

Navigation