카테고리:: 시스템 함수 (시스템 정보)

SYSTEM$CATALOG_LINK_STATUS¶

참고 항목:: Apache Iceberg™ 테이블에 카탈로그 연결 데이터베이스 사용

구문¶

SYSTEM$CATALOG_LINK_STATUS( '<catalog_linked_db_name>' )

Copy

인자¶

'catalog_linked_db_name': 상태를 확인하려는 카탈로그 연결 데이터베이스의 이름을 지정합니다.

반환¶

이 함수는 다음 이름/값 쌍을 포함하는 JSON 오브젝트를 반환합니다.

{
  "executionState":"<value>",
  "failedExecutionStateReason":"<value>",
  "failedExecutionStateErrorCode":"<value>",
  "lastLinkAttemptStartTime":"<value>",
  "failureDetails":[
    {
      "qualifiedEntityName":"<value>",
      "entityDomain":"<value>",
      "operation":"<value>",
      "errorCode":"<value>",
      "errorMessage":"<value>"
    },
    { ... },
    ...
  ]
}

Copy

여기서

executionState
Snowflake가 Iceberg 카탈로그에 연결하는 데 사용하는 연결 작업의 현재 실행 상태입니다.

값:

RUNNING: 다음 테이블 검색 동기화가 예약되거나 실행 중입니다. 모든 테이블이 성공적으로 동기화되었음을 보장하지는 않습니다.

FAILED: 연결 작업에 오류가 발생하여 실패했습니다.

failedExecutionStateReason
FAILED 실행 상태와 관련된 오류 메시지입니다. 마지막 동기화 시도가 성공한 경우 함수 출력에 표시되지 않습니다.

failedExecutionStateErrorCode
FAILED 실행 상태와 관련된 오류 코드입니다. 마지막 동기화 시도가 성공한 경우 함수 출력에 표시되지 않습니다.

lastLinkAttemptStartTime
Snowflake가 원격 카탈로그에서 변경 사항을 검색하고 동기화하는 프로세스를 마지막으로 시작한 시간을 나타내는 타임스탬프입니다.

failureDetails
Snowflake가 동기화할 수 없는 원격 카탈로그의 엔터티(예: 테이블)에 대한 세부 정보를 제공하는 오브젝트 배열입니다. 각 오브젝트에는 다음과 같은 필드가 있습니다.

qualifiedEntityName
카탈로그 이름을 기준으로 원격 카탈로그에 있는 엔터티의 정규화된 이름입니다.

예: namespace_level_1.namespace_level_2.table_name.

유형: 문자열

entityDomain
원격 카탈로그의 엔터티 도메인(예: TABLE)입니다.

유형: 문자열

operation
동기화와 관련된 Snowflake의 작업입니다(예: CREATE(테이블 또는 스키마), DROP).

유형: 문자열

errorCode
실패와 관련된 오류 코드입니다.

유형: 문자열

errorMessage
실패와 관련된 오류 코드입니다.

유형: 문자열

사용법 노트¶

failureDetails 필드는 DROP SCHEMA 및 DROP ICEBERG TABLE 실패에 대한 정보를 반환합니다.
사용자가 지정된 카탈로그 연결 데이터베이스에 대한 권한이 있는 역할을 사용하는 한, 결과를 반환합니다. 자세한 내용은 데이터베이스 권한 섹션을 참조하십시오.

예¶

이름이 my_cld 인 카탈로그 연결 데이터베이스의 링크 상태를 검색합니다.

SELECT SYSTEM$CATALOG_LINK_STATUS('my_cld');

Copy

출력:

{
  "executionState": "RUNNING",
  "lastLinkAttemptStartTime": "2025-02-14T01:35:01.71Z",
  "failureDetails": [
    {
      "qualifiedEntityName": "my_namespace.table_1",
      "entityDomain": "TABLE",
      "operation": "CREATE",
      "errorCode": "0040000",
      "errorMessage": "An internal error occurred. Please contact Snowflake support."
    },
    {
      "qualifiedEntityName": "my_namespace.table_2",
      "entityDomain": "TABLE",
      "operation": "CREATE",
      "errorCode": "0040000",
      "errorMessage": "An internal error occurred. Please contact Snowflake support."
    }
  ]
}