DESCRIBE CATALOG INTEGRATION¶
카탈로그 통합 의 속성을 설명합니다.
DESCRIBE는 DESC로 축약할 수 있습니다.
- 참고 항목:
CREATE CATALOG INTEGRATION , ALTER CATALOG INTEGRATION , DROP CATALOG INTEGRATION , SHOW CATALOG INTEGRATIONS
구문¶
DESC[RIBE] CATALOG INTEGRATION <name>
매개 변수¶
name설명할 카탈로그 통합의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
출력¶
명령의 출력에는 오브젝트의 속성과 메타데이터를 설명하는 다음 열이 포함됩니다.
열 |
설명 |
|---|---|
|
속성의 이름입니다. 이 열에는 다음 표에 나열된 속성이 포함될 수 있습니다. |
|
속성 유형입니다. |
|
속성에 할당된 값입니다. |
|
기본 속성 값입니다. |
property 열에는 카탈로그 통합 오브젝트의 다음 속성을 포함할 수 있습니다.
속성 |
설명 |
|---|---|
|
Apache Iceberg™ 테이블에 카탈로그 통합을 사용할 수 있는지 여부를 지정합니다. |
|
카탈로그 원본의 유형(예: |
|
(AWS Glue) AWS Glue 데이터 카탈로그 네임스페이스를 지정합니다. |
|
카탈로그에서 제공하는 테이블 형식(예: |
|
(AWS Glue) Snowflake가 AWS Glue에 연결할 때 가정하는 ARN 역할의 Amazon 리소스 이름(IAM)입니다. |
|
(AWS Glue) AWS 계정의 ID입니다. |
|
(AWS Glue) AWS Glue Data Catalog의 AWS 리전을 지정합니다. |
|
(AWS Glue) 카탈로그 통합을 생성할 때 Snowflake 계정에 대해 생성된 AWS IAM 사용자의 ARN입니다. |
|
(AWS Glue) Snowflake가 AWS Glue와의 신뢰 관계를 설정하는 데 사용하는 외부 ID입니다. |
|
카탈로그 통합에 대한 설명입니다. |
액세스 제어 요구 사항¶
이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
|---|---|---|
USAGE |
통합(카탈로그) |
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
사용법 노트¶
이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.
예¶
카탈로그 통합을 설명합니다.
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 | | |
+-----------------------+---------------+----------------------------------+------------------+