DESCRIBE CATALOG INTEGRATION¶

카탈로그 통합 의 속성을 설명합니다.

DESCRIBE는 DESC로 축약할 수 있습니다.

참고 항목:: CREATE CATALOG INTEGRATION , ALTER CATALOG INTEGRATION , DROP CATALOG INTEGRATION , SHOW CATALOG INTEGRATIONS

구문¶

DESC[RIBE] CATALOG INTEGRATION <name>

Copy

매개 변수¶

name: 설명할 카탈로그 통합의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

출력¶

명령의 출력에는 오브젝트의 속성과 메타데이터를 설명하는 다음 열이 포함됩니다.

열	설명
`property`	속성의 이름입니다. 이 열에는 다음 표에 나열된 속성이 포함될 수 있습니다.
`property_type`	속성 유형입니다.
`property_value`	속성에 할당된 값입니다.
`property_default`	기본 속성 값입니다.

property 열에는 카탈로그 통합 오브젝트의 다음 속성을 포함할 수 있습니다.

속성	설명
`enabled`	Apache Iceberg™ 테이블에 카탈로그 통합을 사용할 수 있는지 여부를 지정합니다.
`catalog_source`	카탈로그 원본 유형으로, `ICEBERG_REST`, `POLARIS`, `OBJECT_STORE` 또는 `GLUE` (비 REST Glue 통합의 경우)입니다.
`refresh_interval_seconds`	Snowflake가 자동 새로 고침 의 메타데이터 업데이트를 위해 외부 Iceberg 카탈로그를 폴링하는 시도 사이에 대기하는 시간(초)을 지정합니다.
`rest_authentication`	카탈로그 통합을 위한 REST 인증 매개 변수를 지정합니다.
`rest_config`	카탈로그 통합을 위한 REST 구성 매개 변수를 지정합니다.
`catalog_namespace`	이 열의 출력은 다음과 같습니다. 카탈로그 통합이 외부에서 관리되는 Iceberg 테이블을 위한 것이라면 외부 Iceberg 카탈로그의 네임스페이스를 지정합니다. 네임스페이스가 테이블 수준에서만 지정된 경우 이 열은 함수 출력에 값이 없습니다. 카탈로그 통합이 Snowflake 관리 테이블을 Snowflake Open Catalog와 동기화하기 위한 것인 경우 이 필드는 필요하지 않으므로 이 열은 함수 출력에 값이 없습니다.
`table_format`	카탈로그에서 제공하는 테이블 형식(예: `ICEBERG`).
`glue_aws_role_arn`	(AWS Glue) Snowflake가 AWS Glue에 연결할 때 가정하는 ARN 역할의 Amazon 리소스 이름(IAM)입니다.
`glue_catalog_id`	(AWS Glue) AWS 계정의 ID입니다.
`glue_region`	(AWS Glue) AWS Glue Data Catalog의 AWS 리전을 지정합니다.
`glue_aws_iam_user_arn`	(AWS Glue) 카탈로그 통합을 생성할 때 Snowflake 계정에 대해 생성된 AWS IAM 사용자의 ARN입니다.
`glue_aws_external_id`	(AWS Glue) Snowflake가 AWS Glue와의 신뢰 관계를 설정하는 데 사용하는 외부 ID입니다.
`comment`	카탈로그 통합에 대한 설명입니다.

액세스 제어 요구 사항¶

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한	오브젝트	참고
USAGE	통합(카탈로그)

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

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

사용법 노트¶

이 명령의 출력을 후처리하기 위해 파이프 연산자 (->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.

For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

예¶

카탈로그 통합을 설명합니다.

DESC CATALOG INTEGRATION my_catalog_integration;

Copy

다음은 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        |                                  |                  |
+-----------------------+---------------+----------------------------------+------------------+