DYNAMIC_TABLE_REFRESH_HISTORY

DYNAMIC_TABLE_REFRESH_HISTORY

이 테이블 함수는 동적 테이블(dynamic tables)의 각 새로 고침(완료 및 실행 중)에 대한 정보를 반환해요. 이 테이블 함수는 진행 중인 모든 새로 고침과 현재 시간에서 7일 이내의 DATA_TIMESTAMP를 가진 모든 새로 고침을 반환해요.

출처: Snowflake SQL Reference - DYNAMIC_TABLE_REFRESH_HISTORY

본문

구문

DYNAMIC_TABLE_REFRESH_HISTORY(
  [ DATA_TIMESTAMP_START => <constant_expr> ]
  [ , DATA_TIMESTAMP_END => <constant_expr> ]
  [ , RESULT_LIMIT => <integer> ]
  [ , NAME => '<string>' ]
  [ , NAME_PREFIX => '<string>' ]
  [ , ERROR_ONLY => { TRUE | FALSE } ]
)

인자

모든 인자는 선택적이에요. 인자가 제공되지 않으면 계정의 모든 동적 테이블에서 100개의 새로 고침이 반환돼요.

• 새로 고침이 발생한 시간 범위(TIMESTAMP_LTZ 형식)예요.
  • 시작 버전도 종료 버전도 지정되지 않으면 기본 범위는 지난 하루예요.
  • 종료 버전이 지정되지 않으면 CURRENT_TIMESTAMP가 범위의 끝으로 사용돼요.
  • 시작 버전이 지정되지 않으면 범위는 DATE_TIMESTAMP_END 시작 1일 전부터 시작해요.
• 함수가 반환하는 최대 행 수를 지정하는 숫자예요. 일치하는 행 수가 이 제한보다 크면 가장 최근에 완료된 새로 고침(및 여전히 실행 중인 것)이 지정된 제한까지 반환돼요. 결과에 필터를 적용하려면 필터가 모든 동적 테이블에 적용되도록 충분히 큰 RESULT_LIMIT 제한 값도 지정해요. 범위: 1~10000. 기본값: 100.
• 동적 테이블의 이름이에요. 이름은 작은따옴표로 묶어야 하며 대소문자를 구분하지 않아요. 정규화되지 않은 이름(dynamic_table_name), 부분적으로 정규화된 이름(schema_name.dynamic_table_name), 또는 완전히 정규화된 이름(database_name.schema_name.dynamic_table_name)을 지정할 수 있어요. 객체 이름 해석에 대한 자세한 내용은 Object name resolution을 참고해요. 함수는 이 테이블의 새로 고침을 반환해요.
• 동적 테이블의 접두사예요. 이름 접두사는 작은따옴표로 묶어야 하며 대소문자를 구분하지 않아요. 함수는 이 접두사로 시작하는 이름을 가진 테이블의 새로 고침을 반환해요. 이 인자를 사용해 특정 데이터베이스 또는 스키마의 동적 테이블에 대한 새로 고침을 반환할 수 있어요.
• TRUE로 설정하면 이 함수는 실패했거나 취소된 새로 고침만 반환해요.

출력

함수는 다음 컬럼을 반환해요. 이 컬럼을 보려면 MONITOR 권한이 있는 역할을 사용해야 해요. 자세한 내용은 Grant MONITOR to view metadata를 참고해요.

사용상 주의사항

• Information Schema 테이블 함수를 호출할 때는 세션에 INFORMATION_SCHEMA 스키마가 사용 중이어야 하거나 함수 이름이 완전히 정규화되어야 해요. 자세한 내용은 Snowflake Information Schema를 참고해요.

예시

실패했거나 취소된 새로 고침을 검색해요.

SELECT
  name,
  state,
  state_code,
  state_message,
  query_id,
  data_timestamp,
  refresh_start_time,
  refresh_end_time
FROM
  TABLE (
    INFORMATION_SCHEMA.DYNAMIC_TABLE_REFRESH_HISTORY (
      NAME_PREFIX => 'MYDB.MYSCHEMA.', ERROR_ONLY => TRUE
    )
  )
ORDER BY
  name,
  data_timestamp;

더 알아보기

• Information Schema, Table functions
• DYNAMIC_TABLE_GRAPH_HISTORY
• Dynamic tables