REPLICATION_GROUP_USAGE_HISTORY

REPLICATION_GROUP_USAGE_HISTORY

표준 및 비즈니스 크리티컬 기능. 데이터베이스 및 공유 복제는 모든 계정에서 사용할 수 있어요. 다른 계정 객체의 복제 및 장애 조치/장애 복구(failover/failback)에는 비즈니스 크리티컬 에디션(또는 그 이상)이 필요해요. 업그레이드 문의는 Snowflake 지원팀에 문의하세요.

지난 14일 이내의 보조 복제 또는 장애 조치 그룹에 대한 복제 사용 기록을 반환해요.

출처: Snowflake REPLICATION_GROUP_USAGE_HISTORY 함수 문서

본문

참고: 이 함수는 일반적으로 더 완전한 데이터 세트를 제공하고 더 긴 날짜 범위를 지원하는 ACCOUNT_USAGE.REPLICATION_GROUP_USAGE_HISTORY 뷰를 위해 더 이상 사용되지 않아요(deprecated).

구문 (Syntax)

REPLICATION_GROUP_USAGE_HISTORY(
   [ DATE_RANGE_START =>  ]
   [, DATE_RANGE_END =>  ]
   [, REPLICATION_GROUP_NAME => '' ] )

인자 (Arguments)

모든 인자는 선택 사항이에요.

  • DATE_RANGE_START => constant_expr, DATE_RANGE_END => constant_expr — 데이터 로드 기록을 검색할 지난 2주 이내의 날짜/시간 범위:
    • 종료 날짜가 지정되지 않으면, 범위의 끝으로 CURRENT_TIMESTAMP가 사용돼요.
    • 시작 날짜가 지정되지 않으면, 범위는 DATE_RANGE_END의 12시간 전부터 시작돼요.
  • REPLICATION_GROUP_NAME => string — 복제 또는 장애 조치 그룹을 지정하는 문자열이에요. 지정된 그룹에 대한 복제 작업만 반환돼요.

출력 (Output)

이 함수는 다음 컬럼을 반환해요:

컬럼 이름 데이터 타입 설명
START_TIME TIMESTAMP_LTZ 지정된 시간 범위의 시작
END_TIME TIMESTAMP_LTZ 지정된 시간 범위의 끝
REPLICATION_GROUP_NAME TEXT 복제 그룹 이름
CREDITS_USED TEXT START_TIME과 END_TIME 창 동안 복제에 청구된 크레딧 수
BYTES_TRANSFERRED NUMBER START_TIME과 END_TIME 창 동안 복제를 위해 전송된 바이트 수

사용 노트 (Usage Notes)

  • ACCOUNTADMIN 역할 또는 MONITOR USAGE 전역 권한이 명시적으로 부여된 역할에 대해서만 결과를 반환해요.
  • 현재 계정의 보조 복제 또는 장애 조치 그룹에 대해서만 결과를 반환해요.
  • Information Schema 테이블 함수를 호출할 때, 세션에 INFORMATION_SCHEMA 스키마가 사용 중이거나 함수 이름이 정규화(fully-qualified)돼 있어야 해요. 자세한 내용은 Snowflake Information Schema 문서를 참고해요.

예제 (Examples)

지난 7일간의 복제 사용 기록 검색:

SELECT START_TIME, END_TIME, REPLICATION_GROUP_NAME, CREDITS_USED, BYTES_TRANSFERRED
  FROM TABLE(information_schema.replication_group_usage_history(date_range_start=>dateadd('day', -7, current_date())));

복제 그룹 myrg에 대한 지난 7일간의 복제 사용 기록 검색:

SELECT START_TIME, END_TIME, REPLICATION_GROUP_NAME, CREDITS_USED, BYTES_TRANSFERRED
  FROM TABLE(information_schema.replication_group_usage_history(
    date_range_start => dateadd('day', -7, current_date()),
    replication_group_name => 'myrg'
));

더 알아보기