카테고리:

집계 함수 (카디널리티 추정) , 윈도우 함수

APPROX_COUNT_DISTINCT

HyperLogLog를 사용해 입력값 고유 카디널리티의 근삿값을 반환합니다(즉, HLL(col1, col2, ... )COUNT(DISTINCT col1, col2, ... ) 의 근삿값을 반환함).

HyperLogLog에 대한 자세한 내용은 고유 값 개수 추정하기 를 참조하십시오.

별칭:

HLL.

참고 항목:

HLL_ACCUMULATE , HLL_COMBINE , HLL_ESTIMATE

구문

집계 함수

APPROX_COUNT_DISTINCT( [ DISTINCT ] <expr1>  [ , ... ] )

APPROX_COUNT_DISTINCT(*)
Copy

윈도우 함수

APPROX_COUNT_DISTINCT( [ DISTINCT ] <expr1>  [ , ... ] ) OVER ( [ PARTITION BY <expr2> ] )

APPROX_COUNT_DISTINCT(*) OVER ( [ PARTITION BY <expr2> ] )
Copy

인자

expr1

고유 값의 수를 파악하려는 식입니다.

expr2

행을 파티션으로 그룹화하는 데 사용되는 선택적 식입니다.

반환

반환된 값의 데이터 타입은 INTEGER 입니다.

사용법 노트

  • 계산은 근사치이지만, 결정적입니다. 동일한 입력 데이터로 이 함수를 호출하면 이 함수는 동일한 결과를 반환합니다.

  • NULL 값 및 집계 함수에 대한 자세한 내용은 집계 함수 및 NULL 값 을 참조하십시오.

  • 윈도우 함수로 사용되는 경우:

    • 이 함수는 다음을 지원하지 않습니다.

      • OVER() 절의 ORDER BY 하위 절.

      • 윈도우 프레임.

이 예는 APPROX_COUNT_DISTINCT 및 그 별칭 HLL을 사용하는 방법을 보여줍니다. 이 예에서는 COUNT(DISTINCT i)APPROX_COUNT_DISTINCT(i) 를 둘 다 호출하여, 두 함수의 결과가 항상 정확히 일치하는 것은 아님을 강조합니다.

APPROX_COUNT_DISTINCT()는 정확한 값이 아닌 근삿값을 반환하므로 다음 쿼리의 정확한 출력은 다를 수 있습니다.

SELECT COUNT(i), COUNT(DISTINCT i), APPROX_COUNT_DISTINCT(i), HLL(i)
  FROM sequence_demo;
+----------+-------------------+--------------------------+--------+
| COUNT(I) | COUNT(DISTINCT I) | APPROX_COUNT_DISTINCT(I) | HLL(I) |
|----------+-------------------+--------------------------+--------|
|     1024 |              1024 |                     1007 |   1007 |
+----------+-------------------+--------------------------+--------+
Copy