SHOW CATALOG INTEGRATIONS¶
プレビュー機能 --- オープン
すべてのアカウントで利用可能です。
アカウントの カタログ統合 を一覧表示します。出力は、統合メタデータとプロパティを返します。
構文¶
SHOW CATALOG INTEGRATIONS [ LIKE '<pattern>' ]
パラメーター¶
LIKE 'pattern'オプションで、オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（
%および_）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは 同じ 結果を返します。
... LIKE '%testing%' ...... LIKE '%TESTING%' .... デフォルト: 値なし（フィルタリングは出力に非適用）。
アクセス制御の要件¶
この SQL コマンドの実行に使用される ロール には、 最低 1 つ の次の 権限 が必要です。
権限 |
オブジェクト |
メモ |
|---|---|---|
USAGE |
統合 |
|
OWNERSHIP |
統合 |
OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege). |
指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。
セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。
使用上の注意¶
このコマンドは、実行中のウェアハウスを必要としません。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。
出力¶
コマンド出力では、次の列にテーブルプロパティとメタデータが提供されます。
列 |
説明 |
|---|---|
|
カタログの統合名。 |
|
カタログ統合をIcebergテーブルで使用できるかどうかを指定します。 |
|
統合のタイプ値は常に CATALOG です。 |
|
統合のカテゴリ。値は常に CATALOG です。 |
|
統合のコメントを指定する文字列（リテラル）。 |
|
カタログ統合が作成された日時。 |
カタログ統合のために指定できるプロパティの詳細については、 CREATE CATALOG INTEGRATION をご参照ください。
例¶
すべてのカタログ統合を表示します。
SHOW CATALOG INTEGRATIONS;
表示する権限がある、名前が demo で始まるすべてのカタログ統合を表示します。
SHOW CATALOG INTEGRATIONS LIKE 'demo%';