카테고리:

Information Schema , 테이블 함수

MATERIALIZED_VIEW_REFRESH_HISTORY

이 테이블 함수는 지정된 날짜 범위 내에서 지정된 구체화된 뷰에 대한 구체화된 뷰 새로 고침 기록을 쿼리하는 데 사용됩니다. 함수가 반환하는 정보에는 구체화된 뷰가 새로 고쳐질 때마다 소비되는 뷰 이름과 크레딧이 포함됩니다.

구문

MATERIALIZED_VIEW_REFRESH_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [ , DATE_RANGE_END => <constant_expr> ]
      [ , MATERIALIZED_VIEW_NAME => '<string>' ] )

인자

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

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

구체화된 뷰 유지 관리 기록을 표시할 날짜/시간 범위입니다. 예를 들어 시작 날짜를 2019-04-03으로 지정하고 종료 날짜를 2019-04-05로 지정하면 4월 3일, 4월 4일, 4월 5일에 대한 데이터를 가져옵니다. (엔드포인트가 포함됩니다.)

  • 시작 날짜와 종료 날짜가 모두 지정되지 않은 경우, 기본값은 지난 12시간입니다.

  • 종료 날짜는 지정하지 않았지만, 시작 날짜는 지정하는 경우, 자정의 CURRENT_DATE 가 범위의 끝으로 사용됩니다.

  • 시작 날짜는 지정하지 않았지만, 종료 날짜는 지정하는 경우, 범위는 DATE_RANGE_END 시작 12시간 전에 시작됩니다.

MATERIALIZED_VIEW_NAME => string

구체화된 뷰 이름입니다. 지정된 경우, 지정된 구체화된 뷰에 대한 기록만 표시합니다. 이름에는 스키마 이름과 데이터베이스 이름이 포함될 수 있습니다.

이름을 지정하지 않는 경우, 지정된 시간 범위 내에서 유지 관리되는 각 구체화된 뷰에 대한 데이터가 결과에 포함됩니다.

사용법 노트

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

    참고

    MONITOR USAGE 권한이 있는 역할은 오브젝트별 크레딧 사용량을 볼 수 있지만, 오브젝트 이름은 볼 수 없습니다. 이 함수가 이름을 반환하려면 해당 역할에는 오브젝트에 대한 SELECT도 부여되어야 합니다. 역할에 오브젝트 이름을 볼 수 있는 충분한 권한이 없는 경우, 오브젝트 이름이 《unknown_#》와 같은 대체 이름으로 표시될 수 있으며, 여기서 《#》는 한 자리 이상의 숫자를 나타냅니다.

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

  • 기록은 1시간 단위로 표시됩니다.

출력

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

열 이름

데이터 타입

설명

START_TIME

TIMESTAMP_LTZ

지정된 시간 범위의 시작입니다.

END_TIME

TIMESTAMP_LTZ

지정된 시간 범위의 끝입니다.

CREDITS_USED

TEXT

START_TIME 및 END_TIME 기간 동안 구체화된 뷰 유지 관리를 위해 청구된 크레딧 수입니다.

MATERIALIZED_VIEW_NAME

TEXT

구체화된 뷰의 이름입니다.

계정에 대한 1시간 범위의 새로 고침 기록을 검색합니다.

select *
  from table(information_schema.materialized_view_refresh_history(
    date_range_start=>'2019-05-22 19:00:00.000',
    date_range_end=>'2019-05-22 20:00:00.000'));

다음은 샘플 출력입니다.

+-------------------------------+-------------------------------+--------------+-----------------------------------------+
| START_TIME                    | END_TIME                      | CREDITS_USED | MATERIALIZED_VIEW_NAME                  |
|-------------------------------+-------------------------------+--------------+-----------------------------------------|
| 2019-05-22 19:00:00.000 -0700 | 2019-05-22 20:00:00.000 -0700 |  0.223276651 | TEST_DB.TEST_SCHEMA.MATERIALIZED_VIEW_1 |
+-------------------------------+-------------------------------+--------------+-----------------------------------------+

계정에 대한 지난 12시간 동안의 기록을 검색합니다.

select *
  from table(information_schema.materialized_view_refresh_history(
    date_range_start=>dateadd(H, -12, current_timestamp)));

계정에 대한 지난주의 기록을 검색합니다.

select *
  from table(information_schema.materialized_view_refresh_history(
    date_range_start=>dateadd(D, -7, current_date),
    date_range_end=>current_date));

계정의 지정된 구체화된 뷰에 대한 지난주의 유지 관리 기록을 검색합니다.

select *
  from table(information_schema.materialized_view_refresh_history(
    date_range_start=>dateadd(D, -7, current_date),
    date_range_end=>current_date,
    materialized_view_name=>'mydb.myschema.my_materialized_view'));
맨 위로 이동