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

SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG¶

지정된 :doc:`카탈로그 연결 데이터베이스 </user-guide/tables-iceberg-catalog-linked-database>`에 설정된 구성 매개 변수를 반환합니다. 출력은 JSON 형식입니다.

구문¶

SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG('<catalog_linked_database_name>');

인자¶

catalog_linked_database_name

구성을 가져올 카탈로그 연결 데이터베이스의 이름입니다.

작은따옴표로 묶인 문자열 리터럴로 지정합니다.

반환¶

이 함수는 데이터베이스의 구성 매개 변수가 있는 JSON 오브젝트를 포함하는 문자열을 반환합니다.


필드	설명
`catalog_integration`	카탈로그 연결 데이터베이스에서 사용하는 카탈로그 통합의 이름입니다.
`catalog_name`	외부 카탈로그에 있는 카탈로그 네임스페이스의 이름입니다. 지정하지 않으면 `null` 을 반환합니다.
`external_volume`	테이블 저장소에 사용되는 외부 볼륨의 이름입니다.
`sync_interval_seconds`	Snowflake가 변경 사항을 감지하기 위해 원격 카탈로그를 폴링하는 간격(초)입니다.
`namespace_mode`	네임스페이스 처리를 위한 모드입니다. 가능한 값: `FLATTEN_NESTED_NAMESPACE`, `HIERARCHICAL`.
`namespace_flatten_delimiter`	중첩된 네임스페이스를 평면화할 때 사용되는 구분 기호입니다. ``namespace_mode``가 ``FLATTEN_NESTED_NAMESPACE``인 경우에만 적용 가능합니다.
`allowed_write_operations`	카탈로그 연결 데이터베이스에서 허용되는 쓰기 작업의 유형입니다. 가능한 값: `NONE`, `ALL`.
`catalog_case_sensitivity`	카탈로그에 대한 대소문자 구분 설정입니다. 가능한 값: `CASE_SENSITIVE`, `CASE_INSENSITIVE`.
`is_suspended`	카탈로그 연결 데이터베이스 동기화가 일시 중단되었는지 여부입니다. 일시 중단된 경우 ``true``를 반환하며, 그렇지 않으면 ``false``를 반환합니다.
`allowed_namespaces`	동기화가 허용되는 네임스페이스 목록입니다. 모든 네임스페이스가 허용되는 경우 ``null``을 반환합니다.
`blocked_namespaces`	동기화가 차단된 네임스페이스 목록입니다. 차단된 네임스페이스가 없는 경우 ``null``을 반환합니다.

샘플 출력은 예 섹션을 참조하세요.

액세스 제어 요구 사항¶

이 작업을 실행하는 데 사용되는 역할에는 MONITOR, USAGE, OWNERSHIP 또는 ALL 권한이 있어야 합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

예¶

이름이 ``my_db``인 카탈로그 연결 데이터베이스에 대한 구성을 가져옵니다.

SELECT SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG('my_db');

출력 예제:

{
  "catalog_integration": "TEST_GET_CLD_CONFIG_EBEC9E22_44BD_4945_A4C3_A402CCBB86AF_CAT",
  "catalog_name": null,
  "external_volume": "EXVOL_GET_CLD_CONFIG",
  "sync_interval_seconds": 600,
  "namespace_mode": "FLATTEN_NESTED_NAMESPACE",
  "namespace_flatten_delimiter": "_",
  "allowed_write_operations": "NONE",
  "catalog_case_sensitivity": "CASE_INSENSITIVE",
  "is_suspended": false,
  "allowed_namespaces": ["'ns1'", "'ns2'"],
  "blocked_namespaces": ["'blocked_ns1'"]
}