SYSTEM$CATALOG_LINK_STATUS¶

구문¶

SYSTEM$CATALOG_LINK_STATUS( '<catalog_linked_db_name>' )

인자¶

'catalog_linked_db_name'

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

반환¶

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

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

여기서

executionState

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

값:

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

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

  연결 작업이 실패하면 먼저 오류를 해결하세요. 그러면 카탈로그 연결 데이터베이스에 대해 검색이 일시 중단되지 않는 한, Snowflake는 다음 테이블 검색 동기화를 자동으로 예약합니다. 검색을 일시 중단한 경우 오류를 해결한 후 :doc:`ALTER DATABASE … RESUME DISCOVERY</sql-reference/sql/alter-database-catalog-linked>`를 실행하여 검색을 재개합니다.

  예:

  CopyExpand

  ALTER DATABASE IF EXISTS my_linked_db RESUME DISCOVERY;
  

  Show lessSee more

  Scroll to top

failedExecutionStateReason

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

failedExecutionStateErrorCode

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

lastLinkAttemptStartTime

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

failureDetails

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

qualifiedEntityName

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

예: namespace_level_1.namespace_level_2.table_name.

유형: 문자열

entityDomain

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

유형: 문자열

operation

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

• 작업이 ``CATALOG_CONNECTION``인 경우 Snowflake가 원격 카탈로그에 연결을 시도할 때 오류가 발생했습니다.

• 작업이 DISCOVERY``인 경우 Snowflake가 원격 카탈로그에서 테이블 또는 네임스페이스를 검색하려고 할 때 오류가 발생했습니다. 오류를 일으킨 테이블 또는 네임스페이스를 확인하려면 ``TABLE 또는 ``NAMESPACE``가 되는 :code:`entityDomain`을 참조하세요.

유형: 문자열

errorCode

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

유형: 문자열

errorMessage

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

유형: 문자열

액세스 제어 요구 사항¶

이 ` 명령을 실행하는 데 사용되는 <http://docs.snowflake.com/user-guide/security-access-control-overview#roles>역할 _SQL 에는 최소한 다음 `권한 중 하나가 있어야 합니다.

사용법 노트¶

• failureDetails 필드는 DROP SCHEMA 및 DROP ICEBERG TABLE 실패에 대한 정보를 반환합니다.

• 사용자가 지정된 카탈로그 연결 데이터베이스에 대한 권한이 있는 역할을 사용하는 한, 결과를 반환합니다. 자세한 내용은 데이터베이스 권한 섹션을 참조하십시오.

예¶

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

SELECT SYSTEM$CATALOG_LINK_STATUS('my_cld');

출력:

{
  "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."
    }
  ]
}