카테고리:

데이터 메트릭 함수

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

데이터 메트릭 함수가 실행되는 예약된 시간과 타임스탬프 열의 최대값 사이의 차이를 초 단위로 반환합니다.

구문

SNOWFLAKE.CORE.FRESHNESS(<query>)
Copy

인자

query

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

허용되는 데이터 타입

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

  • DATE

  • TIMESTAMP_LTZ

  • TIMESTAMP_TZ

반환

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

액세스 제어 요구 사항

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

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

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

    권한

    오브젝트

    참고

    EXECUTE DATA METRIC FUNCTION

    계정

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

    USAGE

    데이터베이스, 스키마

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

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

  • ACCOUNTADMIN 역할을 사용합니다.

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

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

예

TIMESTAMP 열을 측정하여 테이블에서 데이터의 최신성(300초 또는 5분)을 결정합니다.

SELECT SNOWFLAKE.CORE.FRESHNESS(
  SELECT
    timestamp
  FROM hr.tables.empl_info
) < 300;
Copy
+---------------------------------------------------------------------+
| SNOWFLAKE.CORE.FRESHNESS(SELECT timestamp FROM hr.tables.empl_info) |
+---------------------------------------------------------------------+
| True                                                                |
+---------------------------------------------------------------------+
언어: 한국어