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

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

테이블의 지정된 열에 대해 NULL인 열 값의 백분율을 반환합니다.

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

구문¶

SNOWFLAKE.CORE.NULL_PERCENT(<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 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

예¶

SSN 열(예: US 사회보장번호)에 대한 NULL 값의 백분율을 측정합니다.

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

Copy

+----------------------------------------------------------------+
| SNOWFLAKE.CORE.NULL_COUNT(SELECT ssn FROM hr.tables.empl_info) |
+----------------------------------------------------------------+
| 1                                                              |
+----------------------------------------------------------------+