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'));