- カテゴリ:
ユーザーとセキュリティ DDL (サードパーティのサービス統合)
SHOW INTEGRATIONS¶
アクセス権限がある統合をリストします。このコマンドを使用して、現在の/指定されたデータベースまたはスキーマ、またはアカウント全体の統合をリストできます。
出力は、データベース、スキーマ、および統合名によって辞書順に並べられた統合メタデータとプロパティを返します(出力列の説明については、このトピックの 出力 を参照)。これは、提供されたフィルターを使用して結果をフィルターする場合に注意することが重要です。
- こちらもご参照ください:
- API 統合
- 通知の統合
- セキュリティの統合
- ストレージの統合
構文¶
SHOW [ TERSE ] [ { API | NOTIFICATION | SECURITY | STORAGE } ] INTEGRATIONS [ LIKE '<pattern>' ]
[ IN { ACCOUNT | DATABASE [ <db_name> ] | [ SCHEMA ] [ <schema_name> ] } ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> [ FROM '<name_string>' ] ]
パラメーター¶
TERSE
出力列のサブセットのみを返します。
created_on
name
kind
database_name
schema_name
注釈
このパラメーターは現在サポートされていません。
API | NOTIFICATION | SECURITY | STORAGE
指定されたタイプの統合のみを返します。
LIKE 'パターン'
オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字(
%
および_
)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは同じ結果を返します。
... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
注釈
このパラメーターは現在サポートされていません。
IN ACCOUNT | [ DATABASE ] データベース名 | [ SCHEMA ] スキーマ名
コマンドのスコープを指定します。これは、コマンドが現在/指定されたデータベースまたはスキーマのレコードのみを一覧表示するか、アカウント全体に表示するかを決定します。
DATABASE
またはSCHEMA
キーワードは必須ではありません。データベースまたはスキーマ名のみを指定して、スコープを設定できます。同様に、セッションで現在使用中のデータベースがある場合、データベース名またはスキーマ名は必要ありません。DATABASE
またはSCHEMA
が名前なしで指定され、セッションで現在使用中のデータベースがない場合、パラメーターは出力に影響しません。SCHEMA
が名前で指定され、セッションで現在使用中のデータベースがない場合、スキーマ名はデータベース名で完全修飾する 必要があります (例:testdb.testschema
)。
デフォルト: セッションで現在使用中のデータベースがあるかどうかによって異なります。
データベース:
DATABASE
はデフォルトです(つまり、コマンドは、データベースで表示する権限を持つオブジェクトを返す)。データベースなし:
ACCOUNT
はデフォルトです(つまり、コマンドは、アカウントで表示する権限を持つオブジェクトを返す)。
注釈
このパラメーターは現在サポートされていません。
STARTS WITH '名前文字列'
オブジェクト名の先頭に表示される文字列に基づいてコマンド出力をフィルターします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。たとえば、次の結果は 異なる 結果を返します。
... STARTS WITH 'B' ...
... STARTS WITH 'b' ...
注釈
このパラメーターは現在サポートされていません。
LIMIT 行 [ FROM '名前文字列' ]
返される
行
の最大数を制限することにより、結果の「ページネーション」を有効にします。返される実際の行数は、指定された制限より少ない場合があることに注意してください(例えば、オブジェクトの数が指定された制限より少ない場合)。この句には、結果の「カーソル」として効果的に機能する
FROM
副次句を含めることもできます。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。
文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。
注釈
FROM
同じステートメントでSTARTS WITH
と組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合、互いにキャンセルされ、結果が返されません。さらに、オブジェクトは名前の辞書式順序で返されるため、FROM
は、STARTS WITH
によって返される行よりも辞書式の値が大きい行のみを返します。例:
... STARTS WITH 'A' LIMIT ... FROM 'B'
は結果を返しません。... STARTS WITH 'B' LIMIT ... FROM 'A'
は結果を返しません。... STARTS WITH 'A' LIMIT ... FROM 'AB'
は結果を返します(入力文字列に一致する行がある場合)。
注釈
このパラメーターは現在サポートされていません。
使用上の注意¶
現在、
API | NOTIFICATION | SECURITY | STORAGE
パラメーターのみがサポートされています。
このコマンドの実行には、稼働中のウェアハウスを必要としません。
LIMIT 行
の値は10000
を超えることはできません。LIMIT 行
が省略され、結果セットが10K行より大きい場合、コマンドはエラーになります。10Kを超えるレコードが存在する結果を表示するには、
LIMIT 行
を含めるか、 情報スキーマ の対応するビューをクエリします。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。
出力¶
コマンド出力では、次の列にテーブルプロパティとメタデータが提供されます。
| name | type | category | enabled | created_on |
列 |
説明 |
---|---|
|
統合の名前 |
|
統合のタイプ |
|
統合のカテゴリ |
|
統合の現在のステータス。TRUE (有効)または FALSE (無効)のいずれか |
|
統合が作成された日時 |
統合に指定できるプロパティの詳細については、 タイプごとの統合に関する次のトピックをご参照ください。
例¶
すべての通知統合を表示します。
SHOW NOTIFICATION INTEGRATIONS;
tpch.public
スキーマで表示する権限がある、名前が line
で始まるすべての統合を表示します。
SHOW INTEGRATIONS LIKE 'line%' IN tpch.public;
ドロップされた統合を含む、 tpch.public
スキーマで表示する権限があるすべての統合を表示します。
SHOW INTEGRATIONS HISTORY IN tpch.public;