DATABASE_REFRESH_HISTORY
DATABASE_REFRESH_HISTORY
보조 데이터베이스(secondary database)의 새로고침(refresh) 기록을 반환해요.
본문
참고: 이 함수는 지난 14일 이내의 데이터베이스 새로고침 활동을 반환해요.
참고 항목: DATABASE_REFRESH_PROGRESS, DATABASE_REFRESH_PROGRESS_BY_JOB
구문 (Syntax)
DATABASE_REFRESH_HISTORY( '' )
인자 (Arguments)
secondary_db_name— 보조 데이터베이스의 이름이에요. 보조 데이터베이스가 현재 세션의 활성 데이터베이스인 경우 이 인자는 선택 사항이에요. 전체 이름은 단일 따옴표로 묶어야 해요.
사용 노트 (Usage Notes)
- 계정 관리자(ACCOUNTADMIN 역할을 가진 사용자)에 대해서만 결과를 반환해요.
- Information Schema 테이블 함수를 호출할 때, 세션에 INFORMATION_SCHEMA 스키마가 사용 중이거나 함수 이름이 정규화(fully-qualified)돼 있어야 해요. 자세한 내용은 Snowflake Information Schema 문서를 참고해요.
- 다음은 처리되는 순서대로의 단계(phase) 목록이에요:
- SECONDARY_UPLOADING_INVENTORY
- PRIMARY_UPLOADING_METADATA
- PRIMARY_UPLOADING_DATA
- SECONDARY_DOWNLOADING_METADATA
- SECONDARY_DOWNLOADING_DATA
- COMPLETED / FAILED / CANCELED
출력 (Output)
이 함수는 다음 컬럼을 반환해요:
| 컬럼 이름 | 데이터 타입 | 설명 |
|---|---|---|
| CURRENT_PHASE | TEXT | 현재 복제 단계. 단계 목록은 사용 노트 참고 |
| START_TIME | NUMBER | 복제 작업이 시작된 시간. 형식은 에폭(epoch) 시간 |
| END_TIME | NUMBER | 해당하는 경우 복제 작업이 끝난 시간. 형식은 에폭 시간 |
| JOB_UUID | TEXT | 보조 데이터베이스 새로고침 작업의 쿼리 ID |
| COPY_BYTES | NUMBER | 복제 작업 중 복사된 바이트 수 |
| OBJECT_COUNT | NUMBER | 복제 작업 중 복사된 데이터베이스 객체 수 |
예제 (Examples)
사용자 세션에서 현재 활성인 데이터베이스의 데이터베이스 새로고침 기록 검색:
select *
from table(information_schema.database_refresh_history());
더 알아보기
- Snowflake 정보 스키마 — 관련 정보 스키마 함수