AVAILABLE_LISTING_REFRESH_HISTORY

AVAILABLE_LISTING_REFRESH_HISTORY 함수는 사용 가능한 리스팅(listing) 또는 크로스 클라우드 자동 이행(auto-fulfillment)을 사용해 리스팅에서 마운트된 데이터베이스의 지난 14일간 새로고침 이력을 반환해요.

출처: AVAILABLE_LISTING_REFRESH_HISTORY

본문

AVAILABLE_LISTING_REFRESH_HISTORY 함수는 사용 가능한 리스팅 또는 크로스 클라우드 자동 이행을 사용해 리스팅에서 마운트된 데이터베이스의 지난 14일간의 새로고침 이력을 반환해요. 반환되는 정보에는 각 새로고침 이벤트에서 리스팅 데이터베이스에 추가된 데이터에 대한 복제 관련 세부 정보가 포함돼요. 이 함수는 사용 가능한 리스팅 또는 마운트된 데이터베이스에 대한 권한이 있는 리스팅 소비자(consumer)가 사용할 수 있어요.

구문 (Syntax)

AVAILABLE_LISTING_REFRESH_HISTORY(
  OBJECT_TYPE => '<object_type>',
  OBJECT_NAME => '<object_name>' )

인자 (Arguments)

OBJECT_TYPE => 'object_type' — 객체의 유형으로, listing 또는 database예요.
OBJECT_NAME => 'object_name' — 객체의 이름으로, 객체 유형에 따라 리스팅의 글로벌 이름 또는 마운트된 데이터베이스 이름일 수 있어요.

출력 (Output)

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

열 이름 (Column Name)	데이터 타입 (Data Type)	설명 (Description)
OBJECT_TYPE	TEXT	Snowflake 객체의 유형. 예: `listing`
OBJECT_NAME	TEXT	리스팅 또는 마운트된 데이터베이스의 이름
PHASE	TEXT	복제 작업의 현재 단계로, 총 X 단계 중 한 단계로 표시됨. 예: `2/6`
PHASE_NAME	TEXT	지금까지 완료된(또는 진행 중인) 복제 단계의 이름. 단계 목록은 사용 메모를 참조
PROGRESS	TEXT	`PRIMARY_UPLOADING_DATA`: 복제된 전체 바이트의 백분율. `SECONDARY_DOWNLOADING_METADATA`: 복제된 전체 객체 수의 백분율. `SECONDARY_DOWNLOADING_DATA`: 복제된 전체 바이트의 백분율. 나머지 단계에 대해서는 비어 있음
START_TIME	TIMESTAMP_LTZ	복제 단계가 시작된 시각
END_TIME	TIMESTAMP_LTZ	해당되는 경우 단계가 완료된 시각. 단계가 진행 중이거나 종료 단계(`COMPLETED`/`FAILED`/`CANCELED`)이면 `NULL`
JOB_UUID	TEXT	새로고침 작업의 쿼리 ID
PRIMARY_SNAPSHOT_TIMESTAMP	TIMESTAMP_LTZ	주 스냅샷이 생성된 타임스탬프
ERROR	VARIANT	새로고침 작업이 성공하면 `NULL`. 실패하면 오류에 대한 세부 정보를 제공하는 JSON 객체 반환: `errorCode`(실패의 오류 코드), `errorMessage`(실패의 오류 메시지)

사용 메모 (Usage notes)

리스팅이 계정에 표시되는 경우 리스팅에 대한 권한이 있는 역할에 대해서만 행을 반환해요.
object_type가 database(리스팅이 아닌)로 설정되면 해당 데이터베이스에 대한 권한이 있는 역할에 대해서만 행이 반환돼요.
정보 스키마 테이블 함수를 호출할 때 세션에 사용 중인 INFORMATION_SCHEMA 스키마가 있어야 하거나 함수 이름이 완전히 정규화되어야 해요. 자세한 내용은 Information Schema를 참조해요.
처리 순서의 단계 목록: SECONDARY_SYNCHRONIZING_MEMBERSHIP, SECONDARY_UPLOADING_INVENTORY, PRIMARY_UPLOADING_METADATA, PRIMARY_UPLOADING_DATA, SECONDARY_DOWNLOADING_METADATA, SECONDARY_DOWNLOADING_DATA, COMPLETED / FAILED / CANCELED.

예제 (Examples)

my_mounted_database 데이터베이스의 이력을 검색해요:

SELECT * FROM TABLE(
  INFORMATION_SCHEMA.AVAILABLE_LISTING_REFRESH_HISTORY(
    OBJECT_TYPE=>'database',
    OBJECT_NAME=>'my_mounted_database'
  )
);

더 알아보기 (Learn more)

정보 스키마 (Information Schema)
테이블 함수 (Table functions)
리스팅 (Listings)