카테고리:

Information Schema , 테이블 함수

AUTO_REFRESH_REGISTRATION_HISTORY

이 테이블 함수는 지정된 외부 테이블 또는 디렉터리 테이블의 메타데이터에 등록된 데이터 파일의 기록과 이러한 작업에 대해 청구된 크레딧을 쿼리하는 데 사용할 수 있습니다. 테이블 함수는 전체 Snowflake 계정에 대해 지난 14일 이내에 지정된 범위의 청구 기록을 반환합니다.

참고

Apache Iceberg™ 테이블의 새로 고침 기록 정보를 검색하려면 대신 ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY 섹션을 참조하십시오.

구문

AUTO_REFRESH_REGISTRATION_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ]
      [, OBJECT_TYPE => '<string>' [, OBJECT_NAME => '<string>'] ])
Copy

인자

모든 인자는 선택 사항입니다.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

청구 기간의 날짜/시간 범위:

  • 종료 날짜가 지정되지 않은 경우, CURRENT_DATE 가 범위의 끝으로 사용됩니다.

  • 시작 날짜가 지정되지 않은 경우, 범위는 DATE_RANGE_END 시작 10분 전에 시작됩니다(즉, 기본값은 이전 10분의 청구 기록을 표시하는 것입니다). 예를 들어 DATE_RANGE_END 가 CURRENT_DATE 인 경우, 기본 DATE_RANGE_START 는 전날 오후 11시 50분입니다.

기록은 5분, 1시간 또는 24시간 단위로 표시됩니다(지정된 범위의 길이에 따라 다름).

OBJECT_TYPE => string

크레딧이 청구되는 오브젝트의 유형입니다. 다음 값이 지원됩니다.

DIRECTORY_TABLE

자동 메타데이터 새로 고침을 위해 구성된 디렉터리 테이블입니다.

EXTERNAL_TABLE

자동 메타데이터 새로 고침을 위해 구성된 외부 테이블입니다.

OBJECT_NAME => string

크레딧이 청구되는 외부 테이블 또는 디렉터리 테이블의 이름을 지정하는 문자열입니다.

사용법 노트

  • ACCOUNTADMIN 역할에 대한 결과 또는 MONITOR USAGE 전역 권한이 명시적으로 부여된 역할에 대한 결과만 반환합니다.

  • Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.

출력

이 함수는 다음 열을 반환합니다.

열 이름

데이터 타입

설명

START_TIME

TIMESTAMP_LTZ

지정된 청구 기간의 시작입니다.

END_TIME

TIMESTAMP_LTZ

지정된 청구 기간의 끝입니다.

OBJECT_NAME

TEXT

크레딧이 청구되는 오브젝트의 이름입니다.

OBJECT_TYPE

TEXT

크레딧이 청구되는 오브젝트의 유형입니다.

CREDITS_USED

TEXT

START_TIME 및 END_TIME 기간 동안 지정 오브젝트 또는 오브젝트 유형의 메타데이터에 등록된 데이터 파일에 대해 청구된 크레딧 수입니다.

FILES_REGISTERED

NUMBER

START_TIME 및 END_TIME 기간 동안 등록된 파일 수입니다.

예

이 항목의 모든 예에서는 외부 테이블 메타데이터를 참조합니다. 다른 오브젝트 타입에 대해 유사한 기록 레코드를 검색하려면 쿼리에서 OBJECT_TYPE => string 값을 편집하십시오.

자동 메타데이터 새로 고침을 위해 구성된 계정의 모든 외부 테이블에 대한 청구 기록을 검색합니다. 이 쿼리는 30분 범위의 기록을 5분 주기로 검색합니다.

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>to_timestamp_tz('2021-06-17 12:00:00.000 -0700'),
    date_range_end=>to_timestamp_tz('2021-06-17 12:30:00.000 -0700'),
    object_type=>'external_table'));
Copy

이전 예와 동일하지만, 지난 14일 동안의 청구 기록을 1일 주기로 검색합니다.

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('day',-14,current_date()),
    date_range_end=>current_date(),
    object_type=>'external_table'));
Copy

첫 번째 예와 동일하지만, 지난 14일 동안의 청구 기록을 1일 주기로 검색합니다.

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('day',-14,current_date()),
    date_range_end=>current_date(),
    object_type=>'external_table'));
Copy

지난 12시간 동안의 세션의 활성 스키마에서 myexttable 이라는 외부 테이블에 대한 청구 기록을 1시간 주기로 검색합니다.

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('hour',-12,current_timestamp()),
    object_type=>'external_table',
    object_name=>'myexttable'));
Copy

지난 12시간 동안의 mydb.myschema 스키마에서 myexttable 이라는 외부 테이블에 대한 청구 기록을 1시간 주기로 검색합니다.

select *
  from table(information_schema.auto_refresh_registration_history(
    date_range_start=>dateadd('hour',-12,current_timestamp()),
    object_type=>'external_table',
    object_name=>'mydb.myschema.myexttable'));
Copy
언어: 한국어