카테고리:

데이터 메트릭 함수

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

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

구문

SNOWFLAKE.CORE.NULL_PERCENT(<query>)
Copy

인자

query

테이블 또는 뷰에 SQL 쿼리를 지정합니다.

허용되는 데이터 타입

query 에서 참조되는 열은 다음 데이터 타입 중 하나여야 합니다.

  • DATE

  • FLOAT

  • NUMBER

  • TIMESTAMP_LTZ

  • TIMESTAMP_NTZ

  • TIMESTAMP_TZ

  • VARCHAR

반환

이 함수는 NUMBER 값을 반환합니다.

액세스 제어 요구 사항

시스템 DMF를 사용하려면 다음 액세스 제어 접근법 중 하나를 선택합니다.

  • 테이블에 대한 OWNERSHIP 권한이 있는 역할인 테이블 소유자 역할에 DATA_METRIC_USER 데이터베이스 역할을 부여합니다. 이 데이터베이스 역할에는 SNOWFLAKE.CORE 스키마에 대한 USAGE 권한과 SNOWFLAKE.CORE 스키마의 모든 시스템 DMFs에 대한 USAGE 권한이 있습니다.

    또한, 이 테이블의 권한을 테이블 소유자 역할에 부여합니다.

    권한

    오브젝트

    참고

    EXECUTE DATA METRIC FUNCTION

    계정

    이 권한을 사용하면 시스템 DMF를 호출할 수 있는 서버리스 컴퓨팅 리소스에 액세스할 수 있는 역할을 제어할 수 있습니다.

    USAGE

    데이터베이스, 스키마

    이러한 오브젝트는 query 에서 참조되는 테이블을 포함하는 데이터베이스 및 스키마입니다.

  • 이전 테이블의 권한을 테이블 소유자 역할에 부여합니다. 또한 테이블 소유자 역할에 다음 권한을 부여합니다.

  • ACCOUNTADMIN 역할을 사용합니다.

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

보안 오브젝트 에 대해 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                                                              |
+----------------------------------------------------------------+
언어: 한국어