카테고리:

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 기록 탭 페이지에서 얻을 수 있습니다.

출력

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

열 이름

데이터 타입

설명

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_DATA 및 SECONDARY_DOWNLOADING_DATA 단계에서 totalBytesToReplicate 값은 복제 작업 이전에 추정됩니다. 이 값은 각 단계의 totalBytesToUpload 또는 totalBytesToDownload 값과 다를 수 있습니다.

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

예

복제 그룹 rg1 의 현재 새로 고침 진행률을 검색하려면 다음 문을 실행합니다.

SELECT phase_name, start_time, end_time, progress, details
  FROM TABLE(INFORMATION_SCHEMA.REPLICATION_GROUP_REFRESH_PROGRESS('rg1'));
Copy

쿼리 ID로 복제 그룹 새로 고침 진행률을 검색하려면 예에서 쿼리 ID를 바꾸고 다음 문을 실행합니다.

SELECT phase_name, start_time, end_time, progress, details
  FROM TABLE(
    INFORMATION_SCHEMA.REPLICATION_GROUP_REFRESH_PROGRESS_BY_JOB(
      '012a3b45-1234-a12b-0000-1aa200012345'));
Copy
언어: 한국어