카테고리:

Information Schema , 테이블 함수

DATABASE_REFRESH_PROGRESS , DATABASE_REFRESH_PROGRESS_BY_JOB

DATABASE_REFRESH_PROGRESS 함수 집합을 사용하여 다양한 차원에 따라 데이터베이스 새로 고침 상태를 쿼리할 수 있습니다.

  • DATABASE_REFRESH_PROGRESS는 이름별로 보조 데이터베이스의 현재 새로 고침 상태를 나타내는 JSON 오브젝트를 반환합니다.

  • DATABASE_REFRESH_PROGRESS_BY_JOB은 새로 고침 쿼리를 통해 보조 데이터베이스의 현재 새로 고침 상태를 나타내는 JSON 오브젝트를 반환합니다.

각 함수는 지정된 차원을 따라 쿼리하도록 최적화되어 있습니다.

참고

  • DATABASE_REFRESH_PROGRESS는 데이터베이스 새로 고침이 최근 14일 이내에 발생한 경우, 가장 최근의 데이터베이스 새로 고침에 대한 데이터베이스 새로 고침 활동만 반환합니다.

  • DATABASE_REFRESH_PROGRESS_BY_JOB은 지난 14일 이내의 데이터베이스 새로 고침 활동을 반환합니다.

참고 항목:

DATABASE_REFRESH_HISTORY

구문

DATABASE_REFRESH_PROGRESS( '<secondary_db_name>' )

DATABASE_REFRESH_PROGRESS_BY_JOB( '<query_id>' )
Copy

인자

secondary_db_name

보조 데이터베이스의 이름입니다. 보조 데이터베이스가 현재 세션의 활성 데이터베이스인 경우, 이 인자는 선택 사항입니다.

전체 이름은 작은따옴표로 묶어야 합니다.

query_id

데이터베이스 새로 고침 쿼리의 ID입니다. 쿼리 ID는 웹 인터페이스의 History History tab 페이지에서 얻을 수 있습니다.

사용법 노트

  • 계정 관리자(ACCOUNTADMIN 역할을 가진 사용자)에 대한 결과만 반환합니다.

  • Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.

  • 다음은 처리된 순서의 단계 목록입니다.

    1. SECONDARY_UPLOADING_INVENTORY

    2. PRIMARY_UPLOADING_METADATA

    3. PRIMARY_UPLOADING_DATA

    4. SECONDARY_DOWNLOADING_METADATA

    5. SECONDARY_DOWNLOADING_DATA

    6. COMPLETED / FAILED / CANCELED

출력

이 함수는 다음 열을 반환합니다.

열 이름

데이터 타입

설명

PHASE_NAME

TEXT

지금까지 완료된(또는 진행 중인) 복제 단계의 이름입니다. 단계 목록은 사용법 노트를 참조하십시오.

RESULT

TEXT

복제 단계의 상태입니다. 유효한 상태는 EXECUTING, SUCCEEDED, CANCELLED, FAILED 입니다.

START_TIME

NUMBER

복제 단계가 시작된 시간입니다. 형식은 Epoch 시간입니다.

END_TIME

NUMBER

단계가 완료된 시간입니다(해당하는 경우). 형식은 Epoch 시간입니다.

DETAILS

VARIANT

DATABASE_REFRESH_PROGRESS 함수에서만 반환됩니다. 다음 단계에 대한 자세한 정보를 제공하는 JSON 오브젝트: . - 기본 업로드 데이터: 기본 데이터베이스의 현재 스냅샷 타임스탬프. . - 기본 업로드 데이터보조 다운로드 데이터: 데이터베이스 새로 고침의 총 바이트 수, 그리고 단계에서 지금까지 복사된 바이트 수. . - 보조 다운로드 메타데이터: 기본 데이터베이스의 최신 스냅샷에 있는 테이블, 테이블 열, 모든 데이터베이스 오브젝트(테이블 및 테이블 열 포함)의 수.

mydb1 데이터베이스에 대한 데이터베이스 새로 고침의 현재 진행률을 검색합니다.

select *
from table(information_schema.database_refresh_progress(mydb1));
Copy

쿼리 ID로 데이터베이스 새로 고침의 현재 진행률을 검색합니다.

select *
from table(information_schema.database_refresh_progress_by_job('012a3b45-1234-a12b-0000-1aa200012345'));
Copy