SHOW CATALOG INTEGRATIONS

アカウントの カタログ統合 を一覧表示します。出力は、統合メタデータとプロパティを返します。

こちらもご参照ください。

CREATE CATALOG INTEGRATIONDROP CATALOG INTEGRATIONDESCRIBE CATALOG INTEGRATION

構文

SHOW CATALOG INTEGRATIONS [ LIKE '<pattern>' ]
Copy

パラメーター

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 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

出力

コマンド出力では、次の列にテーブルプロパティとメタデータが提供されます。

説明

name

カタログの統合名。

enabled

カタログ統合をIcebergテーブルで使用できるかどうかを指定します。

type

統合のタイプ値は常に CATALOG です。

category

統合のカテゴリ。値は常に CATALOG です。

comment

統合のコメントを指定する文字列(リテラル)。

created_on

カタログ統合が作成された日時。

カタログ統合のために指定できるプロパティの詳細については、 CREATE CATALOG INTEGRATION をご参照ください。

すべてのカタログ統合を表示します。

SHOW CATALOG INTEGRATIONS;
Copy

表示する権限がある、名前が demo で始まるすべてのカタログ統合を表示します。

SHOW CATALOG INTEGRATIONS LIKE 'demo%';
Copy