DESCRIBE CATALOG INTEGRATION¶
プレビュー機能 --- オープン
すべてのアカウントで利用可能です。
カタログ統合 のプロパティについて説明します。
DESCRIBE は DESCに短縮できます。
構文¶
DESC[RIBE] CATALOG INTEGRATION <name>
パラメーター¶
name説明するカタログ統合の識別子を指定します。識別子にスペースまたは特殊文字が含まれる場合は、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
アクセス制御の要件¶
この SQL コマンドの実行に使用される ロール には、少なくとも次の 権限 が必要です。
権限 |
オブジェクト |
メモ |
|---|---|---|
USAGE |
統合（カタログ） |
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
使用上の注意¶
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。
出力¶
コマンド出力では、次の列にカタログ統合プロパティとメタデータが提供されます。
列 |
説明 |
|---|---|
|
プロパティの名前。プロパティの説明については、 CREATE CATALOG INTEGRATION をご参照ください。 |
|
プロパティの型。 |
|
プロパティに割り当てられた値。 |
|
プロパティのデフォルト値。 |
例¶
統合の列を説明します。
DESC CATALOG INTEGRATION myCatalogInt;
以下に、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 | | | +-----------------------+---------------+----------------------------------+------------------+