LISTING_REFRESH_HISTORY

LISTING_REFRESH_HISTORY (리스팅 새로고침 이력)

크로스-클라우드 자동 이행(auto-fulfillment) 리스팅의 지난 14일 새로고침 이력을 반환해요. 반환된 정보는 리스팅이 지정된 대상 리전에 동기화되는 새로고침 이벤트에 대한 복제 세부 정보를 포함해요.

이 함수는 지정된 리스팅에 대한 권한이 있는 리스팅 프로바이더에게 제공돼요.

출처: Snowflake SQL Reference - LISTING_REFRESH_HISTORY

본문

구문 (Syntax)

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

인자 (Arguments)

필수:

LISTING_NAME => 'listing_name'

이 계정에 있는 크로스-클라우드 자동 이행 리스팅의 SQL 식별자예요. 리스팅의 SQL 식별자는 show listings in data exchange <exchange_name>에서 반환된 name 열에서 찾을 수 있어요. 마찬가지로 데이터 익스체인지의 SQL 식별자는 show data exchanges에서 반환된 name 열에서 찾을 수 있어요.

선택:

SNOWFLAKE_REGION => 'snowflake_region'

리스팅이 복제되어 해당 복제의 새로고침 이력을 볼 수 있는 Snowflake 리전 그룹이에요. SHOW REGIONS가 반환하는 snowflake_region 열과 같은 형식을 따라요. 리전을 지정하지 않으면 모든 대상 리전의 이력이 표시돼요.

REGION_GROUP => 'region_group'

리스팅이 복제되어 그 새로고침 이력을 볼 수 있는 Snowflake 리전 그룹이에요. 기본값은 PUBLIC이에요. 이 인자는 모니터링하는 대상 리전이 미국 정부 또는 Virtual Private Snowflake 리전에 있는 경우에만 지정하면 돼요.

출력 (Output)

이 함수는 다음 열을 반환해요:

Column Name Data Type Description
LISTING_NAME TEXT 이 계정에 있는 크로스-클라우드 자동 이행 리스팅의 이름
SNOWFLAKE_REGION TEXT 리스팅이 복제되는 Snowflake 리전의 이름. 예: aws_us_east_1
REGION_GROUP TEXT 리스팅이 복제되는 Snowflake 리전 그룹의 이름. 예: PUBLIC
PHASE TEXT 복제 작업의 현재 단계. 총 X 단계 중 하나의 단계로 표시됨. 예: 2/6
PHASE_NAME TEXT 지금까지 완료된(또는 진행 중인) 복제 단계의 이름. 단계 목록은 usage notes를 참고
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: 객체 유형(예: users, roles, grants, warehouses, schemas, tables, columns 등). totalObjects: 복제 또는 장애 조치 그룹에서 이 유형의 총 객체 수. completedObjects: 완료된 이 유형의 총 객체 수
PRIMARY_SNAPSHOT_TIMESTAMP TIMESTAMP_LTZ 기본 스냅샷이 생성된 시각
ERROR VARIANT 새로고침 작업이 성공하면 NULL. 새로고침 작업이 실패하면 오류에 대한 상세 정보를 제공하는 JSON 객체를 반환: errorCode: 실패의 오류 코드. errorMessage: 실패의 오류 메시지

사용 참고 사항 (Usage notes)

  • 리스팅에 대한 권한이 있는 역할에 대해서만 행을 반환해요.
  • 현재 계정의 리스팅에 대해서만 행을 반환해요.
  • Information Schema 테이블 함수를 호출할 때 세션에 INFORMATION_SCHEMA 스키마가 사용 중이어야 하거나, 함수 이름이 정규화(fully-qualified)되어야 해요. 자세한 내용은 Information Schema를 참고하세요.
  • 처리되는 순서의 단계 목록: SECONDARY_SYNCHRONIZING_MEMBERSHIP, SECONDARY_UPLOADING_INVENTORY, PRIMARY_UPLOADING_METADATA, PRIMARY_UPLOADING_DATA, SECONDARY_DOWNLOADING_METADATA, SECONDARY_DOWNLOADING_DATA, COMPLETED / FAILED / CANCELED.
  • 출력에는 같은 데이터베이스를 참조하는 다른 리스팅의 이력도 포함되며, 이들은 함께 새로고침돼요. 입력이 애플리케이션 리스팅이면 주어진 리전의 모든 애플리케이션 리스팅의 이력을 포함해요.
  • PRIMARY_UPLOADING_DATA와 SECONDARY_DOWNLOADING_DATA 단계에서 totalBytesToReplicate 값은 복제 작업 이전에 추정돼요. 이 값은 해당 단계의 totalBytesToUpload 또는 totalBytesToDownload 값과 다를 수 있어요. 예를 들어 PRIMARY_UPLOADING_DATA 단계에서 이전 복제 작업이 일부 바이트를 업로드했지만 작업이 완료되기 전에 취소된 경우, 해당 바이트는 다시 업로드되지 않아요. 이 경우 totalBytesToUpload는 totalBytesToReplicate보다 낮아요.

예시 (Examples)

공개 클라우드 리전인 AWS US East-1로 새로고침하는 리스팅 my_listing의 이력을 검색해요:

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

더 알아보기 (Learn more)