카테고리:

Information Schema , 테이블 함수

REPLICATION_GROUP_REFRESH_PROGRESS, REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB

REPLICATION_GROUP_REFRESH_PROGRESS 함수 집합을 사용하여 복제 또는 장애 조치 그룹 새로 고침 상태를 쿼리할 수 있습니다.

  • REPLICATION_GROUP_REFRESH_PROGRESS 는 이름별로 보조 복제 또는 장애 조치 그룹의 새로 고침 상태를 나타내는 JSON 오브젝트를 반환합니다.

  • REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB 는 쿼리 ID별로 보조 복제 또는 장애 조치 그룹의 새로 고침 상태를 나타내는 JSON 오브젝트를 반환합니다.

참고

  • REPLICATION_GROUP_REFRESH_PROGRESS 는 가장 최근 새로 고침에 대한 복제 또는 장애 조치 그룹 새로 고침 활동만 반환합니다(최근 14일 이내에 발생한 경우).

  • REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB 은 지난 14일 이내의 복제 또는 장애 조치 그룹 새로 고침 활동을 반환합니다.

구문

REPLICATION_GROUP_REFRESH_PROGRESS( '<secondary_group_name>' )

REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB( '<query_id>' )
Copy

인자

secondary_group_name

보조 복제 또는 장애 조치 그룹의 이름입니다. 전체 이름은 작은따옴표로 묶어야 합니다.

query_id

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

출력

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

열 이름

데이터 타입

설명

PHASE_NAME

TEXT

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

START_TIME

TIMESTAMP_LTZ

복제 단계가 시작된 시간입니다.

END_TIME

TIMESTAMP_LTZ

해당하는 경우, 단계가 완료된 시간입니다. 단계가 진행 중이거나 종료 단계(COMPLETED/FAILED/CANCELED)인 경우 NULL 입니다.

PROGRESS

TEXT

  • PRIMARY_UPLOADING_DATA: 복제된 총 바이트의 백분율입니다.

  • SECONDARY_DOWNLOADING_METADATA: 복제된 총 오브젝트 수에 대한 백분율입니다.

  • SECONDARY_DOWNLOADING_DATA: 복제된 총 바이트의 백분율입니다.

나머지 단계에 대해 비어 있음

DETAILS

VARIANT

  • PRIMARY_UPLOADING_METADATA 단계의 경우:

    • primarySnapshotTimestamp: 기본 스냅샷이 생성된 시간입니다. 형식은 Epoch 시간입니다.

  • PRIMARY_UPLOADING_DATA 단계의 경우:

    • totalBytesToReplicate: 업로드될 것으로 예상되는 총 바이트 수입니다.

    • totalBytesToUpload: 업로드해야 하는 총 바이트 수입니다.

    • bytesUploaded: 지금까지 업로드된 총 바이트 수입니다.

    • databases: 각 구성원 데이터베이스에 대한 다음 필드를 포함하는 JSON 오브젝트의 목록:

      • name: 데이터베이스 이름.

      • totalBytesToReplicate: 데이터베이스에 대해 업로드될 것으로 예상되는 총 바이트입니다.

  • SECONDARY_DOWNLOADING_DATA 단계의 경우:

    • totalBytesToReplicate: 다운로드될 것으로 예상되는 총 바이트 수입니다.

    • totalBytesToDownload: 다운로드에 필요한 실제 바이트 수입니다.

    • bytesDownloaded: 지금까지 다운로드한 실제 바이트 수입니다.

    • databases: 각 구성원 데이터베이스에 대한 다음 필드를 포함하는 JSON 오브젝트의 목록:

      • name: 데이터베이스 이름.

      • totalBytesToReplicate: 데이터베이스에 대해 다운로드될 것으로 예상되는 총 바이트입니다.

  • SECONDARY_DOWNLOADING_METADATA 단계의 경우:

    • totalObjects: 다운로드할 총 오브젝트 수입니다.

    • completedObjects: 지금까지 다운로드한 총 오브젝트 수입니다.

    • objectTypes: 각 오브젝트 유형에 대한 다음 필드를 포함하는 JSON 오브젝트의 목록:

      • objectType: 오브젝트 유형(예: 사용자, 역할, 권한 부여, 웨어하우스, 스키마, 테이블, 열 등)입니다.

      • totalObjects: 이 유형의 총 오브젝트 수입니다.

      • completedObjects: 이 유형의 완료된 오브젝트 수입니다.

  • FAILED 단계의 경우:

    • errorCode: 실패의 오류 코드입니다.

    • errorMessage: 실패의 오류 메시지입니다.

사용법 노트

  • 복제 또는 장애 조치 그룹에 대한 권한이 있는 역할에 대한 행만 반환합니다.

  • 현재 계정의 보조 복제 또는 장애 조치 그룹에 대한 행만 반환합니다.

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

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

    1. SECONDARY_SYNCHRONIZING_MEMBERSHIP

    2. SECONDARY_UPLOADING_INVENTORY

    3. PRIMARY_UPLOADING_METADATA

    4. PRIMARY_UPLOADING_DATA

    5. SECONDARY_DOWNLOADING_METADATA

    6. SECONDARY_DOWNLOADING_DATA

    7. COMPLETED / FAILED / CANCELED

  • PRIMARY_UPLOADING_DATASECONDARY_DOWNLOADING_DATA 단계에서 totalBytesToReplicate 값은 복제 작업 이전에 추정됩니다. 이 값은 각 단계의 totalBytesToUpload 또는 totalBytesToDownload 값과 다를 수 있습니다.

    예를 들어, PRIMARY_UPLOADING_DATA 단계 중에 이전 복제 작업이 일부 바이트를 업로드했지만 작업이 완료되기 전에 취소된 경우 해당 바이트는 다시 업로드되지 않습니다. 그럴 경우 totalBytesToUploadtotalBytesToReplicate 보다 낮습니다.

rg1 복제 그룹에 대한 복제 그룹 새로 고침의 현재 진행률 검색:

select *
from table(information_schema.replication_group_refresh_progress('rg1'));
Copy

쿼리 ID로 복제 그룹 새로 고침의 현재 진행률 검색:

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