카테고리:: Information Schema , 테이블 함수

LISTING_REFRESH_HISTORY¶

클라우드 간 자동 복제 목록에 대한 지난 14일간의 새로 고침 기록을 반환합니다. 반환되는 정보에는 목록이 지정된 대상 리전으로 동기화되는 새로 고침 이벤트에 대한 복제 세부 정보가 포함됩니다.

이 함수는 지정된 목록에 대한 권한이 있는 목록 공급자가 사용할 수 있습니다.

구문¶

LISTING_REFRESH_HISTORY(
  LISTING_NAME => '<listing_name>'
  [ , SNOWFLAKE_REGION => '<snowflake_region>' ]
  [ , REGION_GROUP => '<region_group>' ] )

Copy

인자¶

필수 사항

LISTING_NAME => 'listing_name': 이 계정에 있는 클라우드 간 자동 복제 목록의 SQL 식별자입니다. SQL 목록의 식별자는 데이터 교환의 목록 표시 <exchange_name>에서 반환되는 이름 열에서 찾을 수 있습니다. 마찬가지로 데이터 교환에 대한 SQL 식별자는 show data exchanges 에서 반환하는 이름 열에서 찾을 수 있습니다.

선택 사항

SNOWFLAKE_REGION => 'snowflake_region'

목록이 복제된 Snowflake 리전 그룹으로, 해당 복제에 대한 새로 고침 기록을 볼 수 있습니다. 이는 SHOW REGIONS 에서 반환한 snowflake_region 열과 동일한 형식을 따릅니다. 리전을 지정하지 않으면 모든 대상 리전에 대한 리전 기록이 표시됩니다.

REGION_GROUP => 'region_group'

새로 고침 기록을 볼 수 있는 목록이 복제된 Snowflake 리전 그룹입니다.

기본적으로 PUBLIC 입니다. 이 인자는 모니터링 대상 리전이 US 정부 또는 Virtual Private Snowflake 리전에 있는 경우에만 지정하면 됩니다.

출력¶

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

열 이름	데이터 타입	설명
LISTING_NAME	TEXT	이 계정에 있는 클라우드 간 자동 복제 목록의 이름입니다.
SNOWFLAKE_REGION	TEXT	목록이 복제되는 Snowflake Region의 이름입니다. 예: `aws_us_east_1`.
REGION_GROUP	TEXT	목록이 복제되는 Snowflake 리전 그룹의 이름입니다. 예: PUBLIC.
PHASE	TEXT	복제 작업의 현재 단계로, 총 X단계 중 하나의 단계로 표시됩니다. 예: 2/6.
PHASE_NAME	TEXT	지금까지 완료된(또는 진행 중인) 복제 단계의 이름입니다. 단계 목록은 사용법 노트 섹션을 참조하십시오.
PROGRESS	TEXT	현재 복제 진행률을 백분율로 표시합니다.
START_TIME	TIMESTAMP_LTZ	복제 단계가 시작된 시간입니다.
END_TIME	TIMESTAMP_LTZ	단계가 완료된 시간입니다(해당하는 경우). 단계가 진행 중이거나 종료 단계인 경우(`COMPLETED/FAILED/CANCELED`) NULL.
JOB_UUID	TEXT	새로 고침 작업의 쿼리 ID입니다.
TOTAL_BYTES	VARIANT	새로 고친 데이터베이스에 대한 자세한 정보를 제공하는 JSON 오브젝트: `totalBytesToReplicate`: 복제될 것으로 예상되는 총 바이트 수입니다. `bytesUploaded`: 업로드된 실제 바이트 수입니다. `bytesDownloaded`: 다운로드된 실제 바이트 수입니다. `bytesSkipped`: Egress Cost Optimizer가 활성화된 경우 새로 고침 중에 건너뛴 바이트 수입니다. `databases`: 각 구성원 데이터베이스에 대한 다음 필드를 포함하는 JSON 오브젝트의 목록: `name`: 데이터베이스의 이름입니다. `totalBytesToReplicate`: 데이터베이스에 대해 복제될 것으로 예상되는 총 바이트입니다.
OBJECT_COUNT	VARIANT	새로 고친 오브젝트에 대한 자세한 정보를 제공하는 JSON 오브젝트: `totalObjects`: 복제 또는 장애 조치 그룹의 총 오브젝트 수입니다. `completedObjects`: 완료된 총 오브젝트 수입니다. `objectTypes`: 각 유형에 대한 다음 필드를 포함하는 JSON 오브젝트의 목록: `objectType`: 오브젝트 유형(예: 사용자, 역할, 권한 부여, 웨어하우스, 스키마, 테이블, 열 등)입니다. `totalObjects`: 복제 또는 장애 조치 그룹에서 이 유형의 오브젝트 총수입니다. `completedObjects`: 완료된 이 유형의 총 오브젝트 수입니다.
PRIMARY_SNAPSHOT_TIMESTAMP	TIMESTAMP_LTZ	기본 스냅샷이 생성된 타임스탬프입니다.
ERROR	VARIANT	새로 고침 작업이 성공한 경우 NULL입니다. 새로 고침 작업이 실패하는 경우, 오류에 대한 자세한 정보를 제공하는 JSON 오브젝트를 반환합니다. `errorCode`: 실패의 오류 코드입니다. `errorMessage`: 실패의 오류 메시지입니다.

사용법 노트¶

목록에 대한 권한이 있는 역할에 대한 행만 반환합니다.
현재 계정에 있는 목록의 행만 반환합니다.
Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다.

자세한 내용은 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 보다 낮습니다.

예¶

퍼블릭 클라우드 리전인 AWS US 동부-1로 새로 고침된 my_listing 목록의 기록을 검색합니다.

select * from table(information_schema.listing_refresh_history(listing_name=>'my_listing',snowflake_region=>'AWS_US_EAST_1'))

Copy