카테고리:

데이터 메트릭 함수

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

DMF가 실행되도록 예약된 시점의 타임스탬프 또는 함수가 수동으로 호출된 경우 현재 타임스탬프를 반환합니다.

이 DMF를 사용하여 사용자 지정 메트릭을 정의하여 데이터의 최신성을 측정하거나 이미 존재하는 DMFs와 함께 증분 메트릭을 정의할 수 있습니다.

구문

SNOWFLAKE.CORE.DATA_METRIC_SCHEDULED_TIME()
Copy

인자

없습니다.

반환

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

액세스 제어 요구 사항

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

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

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

    권한

    오브젝트

    참고

    EXECUTE DATA METRIC FUNCTION

    계정

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

    USAGE

    데이터베이스, 스키마

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

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

  • ACCOUNTADMIN 역할을 사용합니다.

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

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

사용법 노트

SELECT 쿼리에서 이 함수를 수동으로 호출하면 CURRENT_TIMESTAMP 함수와 동일한 값이 반환됩니다.

예

지난 1시간 동안 테이블의 데이터 최신성을 확인하기 위해 사용자 지정 데이터 메트릭 함수를 만듭니다.

CREATE OR REPLACE DATA METRIC FUNCTION data_freshness_hour(
  ARG_T TABLE (ARG_C TIMESTAMP_LTZ))
  RETURNS NUMBER AS
  'SELECT TIMEDIFF(
     minute,
     MAX(ARG_C),
     SNOWFLAKE.CORE.DATA_METRIC_SCHEDULED_TIME())
   FROM ARG_T';
Copy

데이터 메트릭 함수를 수동으로 호출합니다.

SELECT data_freshness_hour(SELECT last_updated FROM hr.tables.empl_info) < 60;
Copy

이 문은 지난 1시간(60분) 동안 테이블에 대한 업데이트가 없는 경우 True 를 반환합니다.

이 문은 1시간 전에 테이블에 업데이트가 발생한 경우 False 를 반환합니다.

언어: 한국어