REPLICATION_USAGE_HISTORY

REPLICATION_USAGE_HISTORY

REPLICATION_USAGE_HISTORY 테이블 함수는 지정된 날짜 범위 내에서 지정된 데이터베이스의 복제 기록을 조회하는 데 사용해요. 이 함수가 반환하는 정보에는 복제에 사용된 데이터베이스 이름, 소비된 크레딧, 전송된 바이트가 포함돼요.

폐기된 기능 (Deprecated Feature): 이 함수는 폐기되었어요. DATABASE_REPLICATION_USAGE_HISTORY를 대신 사용하세요.

참고: 이 함수는 최근 14일 이내의 복제 사용 활동을 반환해요.

출처: 문서

본문

문법 (Syntax)

REPLICATION_USAGE_HISTORY(
  [ DATE_RANGE_START => <constant_expr> ]
  [ , DATE_RANGE_END => <constant_expr> ]
  [ , DATABASE_NAME => '<string>' ] )

인자 (Arguments)

모든 인자는 선택적이에요.

  • 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이에요.
  • DATABASE_NAME => 'string' — 데이터베이스 이름이에요. 지정하면 지정된 데이터베이스의 기록만 표시돼요. 이름을 지정하지 않으면 지정된 시간 범위 내에서 복제된 각 데이터베이스의 데이터가 결과에 포함돼요.

출력 (Output)

이 함수는 JSON 객체에 다음 요소를 반환해요:

열 이름 (Column Name) 데이터 타입 (Data Type) 설명 (Description)
START_TIME TIMESTAMP_LTZ 지정된 시간 범위의 시작
END_TIME TIMESTAMP_LTZ 지정된 시간 범위의 끝
DATABASE_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 스키마가 사용 중이거나 함수 이름이 정규화되어야 해요. 자세한 내용은 Snowflake Information Schema를 참조하세요.

예제 (Examples)

계정의 30분 범위에 대한 복제 기록을 검색해요:

select *
  from table(information_schema.replication_usage_history(
    date_range_start=>'2019-02-10 12:00:00.000 +0000',
    date_range_end=>'2019-02-10 12:30:00.000 +0000'));

계정의 최근 12시간 기록을 검색해요:

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

계정의 지난주 기록을 검색해요:

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

계정의 지정된 데이터베이스에 대한 지난주 복제 기록을 검색해요:

select *
  from table(information_schema.replication_usage_history(
    date_range_start=>dateadd(d, -7, current_date),
    date_range_end=>current_date,
    database_name=>'mydb'));

더 알아보기 (Learn more)