카테고리:: 데이터 메트릭 함수

UNIQUE_COUNT(시스템 데이터 메트릭 함수)¶

테이블에서 지정된 열에 대한 NULL이 아닌 고유 값의 총 개수를 반환합니다.

이 항목에서는 함수를 직접 호출하기 위한 구문을 제공합니다. 함수를 테이블 또는 뷰와 연결하여 규칙적인 간격으로 실행되도록 하는 방법을 알아보려면 DMF 를 연결하여 데이터 품질 검사 자동화하기 섹션을 참조하세요.

구문¶

SNOWFLAKE.CORE.UNIQUE_COUNT(<query>)

Copy

인자¶

query: 단일 열을 프로젝션하는 SQL 쿼리를 지정합니다.

허용되는 데이터 타입¶

query 에 의해 프로젝션된 열에는 다음 데이터 타입 중 하나가 있어야 합니다.

DATE
FLOAT
NUMBER
TIMESTAMP_LTZ
TIMESTAMP_NTZ
TIMESTAMP_TZ
VARCHAR

반환¶

이 함수는 NUMBER 데이터 타입의 스칼라 값을 반환합니다.

액세스 제어 요구 사항¶

시스템 DMF를 연결하고 실행하려면 시스템 DMF에 대한 USAGE 권한이 필요합니다. 사용자에게 모든 시스템 DMFs에 대한 USAGE 권한을 부여하기 위해 SNOWFLAKE.DATA_METRIC_USER 데이터베이스 역할을 부여할 수 있습니다. 자세한 내용은 시스템 DMFs에 대해 USAGE 권한 부여 섹션을 참조하십시오.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트¶

시스템 DMF를 수동으로 호출할 때는 사용 중인 허용 데이터 타입을 지정할 필요가 없습니다. 측정할 열에 대한 쿼리만 지정하면 됩니다. Snowflake는 함수에 허용되는 데이터 타입을 열의 데이터 타입과 일치시킵니다.

예¶

SSN 열(즉, US Social Security 번호)의 NULL이 아닌 고유 값 개수를 측정합니다.

SELECT SNOWFLAKE.CORE.UNIQUE_COUNT(
  SELECT
    ssn
  FROM hr.tables.empl_info
);

Copy

+------------------------------------------------------------------+
| SNOWFLAKE.CORE.UNIQUE_COUNT(SELECT ssn FROM hr.tables.empl_info) |
+------------------------------------------------------------------+
| 42                                                               |
+------------------------------------------------------------------+