DESCRIBE CATALOG INTEGRATION
DESCRIBE CATALOG INTEGRATION
DESCRIBE CATALOG INTEGRATION 명령은 카탈로그 통합(catalog integration)의 속성을 설명하는 명령이에요. DESCRIBE는 DESC로 줄여 쓸 수 있습니다.
본문
카탈로그 통합의 속성을 설명하는 명령입니다. DESCRIBE는 DESC로 줄여 쓸 수 있어요.
관련 명령: CREATE CATALOG INTEGRATION, ALTER CATALOG INTEGRATION, DROP CATALOG INTEGRATION, SHOW CATALOG INTEGRATIONS
Syntax
DESC[RIBE] CATALOG INTEGRATION <name>
Parameters
name— 설명할 카탈로그 통합의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요.
Output (출력)
명령 출력에는 객체의 속성과 메타데이터를 설명하는 다음 컬럼이 포함돼요.
property 컬럼은 카탈로그 통합 객체의 다음 속성을 포함할 수 있어요.
- 자동 새로 고침을 위해 자동 조정을 지원하는 외부 Iceberg 카탈로그의 메타데이터 업데이트를 폴링하려는 시도 사이에 Snowflake가 대기하는 시간(초)을 지정해요.
Access control requirements (접근 제어 요구 사항)
이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.
지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요.
Examples (예제)
카탈로그 통합을 설명해 봅시다.
DESC CATALOG INTEGRATION my_catalog_integration;
다음은 AWS Glue 카탈로그 통합의 DESCRIBE CATALOG INTEGRATION 출력을 보여줘요. 출력에는 AWS Glue 고유 속성(예: GLUE_AWS_ROLE_ARN)과 공통 카탈로그 통합 속성이 포함됩니다.
+-----------------------+---------------+----------------------------------+------------------+
| property | property_type | property_value | property_default |
+-----------------------+---------------+----------------------------------+------------------+
| ENABLED | Boolean | true | false |
| CATALOG_SOURCE | String | GLUE | |
| CATALOG_NAMESPACE | String | dbname | |
| TABLE_FORMAT | String | ICEBERG | |
| GLUE_AWS_ROLE_ARN | String | arn:aws:iam::123:role/dummy-role | |
| GLUE_CATALOG_ID | String | 123456789012 | |
| GLUE_REGION | String | us-west-2 | |
| GLUE_AWS_IAM_USER_ARN | String | arn:aws:iam::123:user/example | |
| GLUE_AWS_EXTERNAL_ID | String | exampleGlueExternalId | |
| COMMENT | String | | |
+-----------------------+---------------+----------------------------------+------------------+