SHOW SHARES¶
プロバイダーの共有は、ほとんどのアカウントでデフォルトで有効になっていますが、すべてのアカウントで有効なわけではありません。
コンシューマーとデータを共有しようとしたときにエラーが発生した場合、アカウントでこの機能が有効になっていない可能性があります。有効化については、 Snowflakeサポート にお問い合わせください。
システムで利用可能なすべての 共有 をリストします。
アカウントで(プロバイダーとして)作成されたアウトバウンド共有(コンシューマーへ)。
アカウントが使用できるインバウンド共有(プロバイダーから)。
- こちらもご参照ください。
構文¶
SHOW SHARES [ LIKE '<pattern>' ]
[ LIMIT <rows> [ FROM '<name_string>' ] ]
パラメーター¶
LIKE 'pattern'
オブジェクト名でコマンド出力をフィルターします。フィルターは、 SQL ワイルドカード文字(
%
および_
)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。たとえば、次のパターンは同じ結果を返します。
... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
STARTS WITH 'name_string'
オブジェクト名の先頭に表示される文字列に基づいてコマンド出力をフィルターします。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。たとえば、次の結果は 異なる 結果を返します。
... STARTS WITH 'B' ...
... STARTS WITH 'b' ...
LIMIT rows [ FROM 'name_string' ]
オプションで、返される行の最大数を制限すると同時に、結果の「ページネーション」を有効にします。返される実際の行数は、指定された制限より少ない場合があります(例:既存のオブジェクトの数が指定された制限より少ない)。
オプションの
FROM 'name_string'
サブ句は、結果の「カーソル」として効果的に機能します。これにより、指定された文字列と一致するオブジェクト名を持つ最初の行に続く指定された行数を取得できます。文字列は一重引用符で囲む必要があり、 大文字と小文字を区別します。
文字列に完全なオブジェクト名を含める必要はありません。部分的な名前がサポートされています。
デフォルト:値なし(出力に制限は適用されない)
注釈
STARTS WITH 'name_string'
とFROM 'name_string'
の両方は、同じステートメントで組み合わせることができます。ただし、両方の条件を満たしている必要があります。そうでない場合は、相互にキャンセルされ、結果が返されません。さらに、オブジェクトは名前の辞書式順序で返されるため、
FROM 'name_string'
は、STARTS WITH 'name_string'
によって返される行よりも辞書式の値が大きい行のみを返します。例:
... STARTS WITH 'A' LIMIT ... FROM 'B'
は結果を返しません。... STARTS WITH 'B' LIMIT ... FROM 'A'
は結果を返しません。... STARTS WITH 'A' LIMIT ... FROM 'AB'
は結果を返します(入力文字列に一致する行がある場合)。
使用上の注意¶
このコマンドは、 IMPORT SHARE 権限を持つロールがあるユーザーの共有のみをリストします。
デフォルトでは、 ACCOUNTADMIN ロールにこの権限があります。
ACCOUNTADMIN ロールを持つユーザーは、この権限を委任できます。 ACCOUNTADMIN 以外のロールによる、データ共有タスクの実行の有効化 をご参照ください。
IMPORT SHARE 権限のないユーザーがこのコマンドを実行すると、共有はリストされません。
注釈
十分な権限なしでこのコマンドを実行すると、空の結果が返されます。
このコマンドの実行には、稼働中のウェアハウスを必要としません。
コマンドは、コマンドを実行するために使用されるロールのアクセス権によって決定された通り、指定されたオブジェクトタイプに対して 最大 10Kのレコードを返します。フィルタが適用されていても、10Kの制限を超えるレコードは返されません。
10Kを超える記録が存在する結果を表示するには、 Snowflake Information Schema で対応するビュー(存在する場合)をクエリします。
このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。
出力¶
kind
列には次が表示されます。INBOUND
は、アカウントによって共有が使用できることを示します(つまり、共有からデータベースを作成できます)。OUTBOUND
は、アカウントが他のアカウントとデータを共有しており、この共有がアカウントで作成されたことを示します。
OUTBOUND
共有の場合、アカウントが共有に追加されていると、to
列にこれらのアカウントが表示されます。この列に表示されるアカウントの最大数は3です。ただし、共有に追加できるアカウントの数にハード制限はありません。
例¶
アカウントで作成された、またはアカウントで使用できるすべての共有を表示します。
SHOW SHARES; +-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+ | created_on | kind | name | database_name | to | owner | comment | |-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------| | 2016-07-09 19:18:09.821 -0700 | INBOUND | SFC_SAMPLES.SAMPLE_DATA | SNOWFLAKE_SAMPLE_DATA | | | Sample data sets provided by Snowflake | | 2017-06-15 17:02:29.625 -0700 | OUTBOUND | AB67890.SALES_S | SALES_DB | XY12345, YZ23456 | ACCOUNTADMIN | | +-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+Copy
アカウントで作成されているか、文字列「SNOW」を含むアカウントで使用できる、すべての共有を表示します。
SHOW SHARES LIMIT 5 FROM 'SNOW'; +-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+ | created_on | kind | name | database_name | to | owner | comment | listing_global_name | |-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------| | 2020-07-07 19:18:09.821 -0700 | OUTBOUND | EXAMPLE.SNOW_DATA | EXAMPLE | | ACCOUNTADMIN | | | | 2020-07-10 19:18:09.821 -0700 | OUTBOUND | EXAMPLE.DATA_SNOWS | EXAMPLE | | ACCOUNTADMIN | | | | 2022-08-18 12:02:29.625 -0700 | OUTBOUND | ALFALFA_DB.SNOW_DATA | ALFALFA_DB | AB12345, YZ23456 | ACCOUNTADMIN | | | | 2022-08-18 13:04:29.625 -0700 | OUTBOUND | SALES_DB.SNOW_SHARE | SALES_DB | AB12345 | ACCOUNTADMIN | | | | 2022-08-18 14:02:40.625 -0700 | OUTBOUND | SALES_DB.SNOWIER_SHARE | SALES_DB | | ACCOUNTADMIN | | | +-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+Copy
アカウントで作成されているか、SNOW ではじまるアカウントで使用できる、すべての共有を辞書式順に表示します。
SHOW SHARES STARTS WITH 'SNOW' LIMIT 5 FROM 'A'; +-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+ | created_on | kind | name | database_name | to | owner | comment | listing_global_name | |-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------| | 2020-07-07 19:18:09.821 -0700 | OUTBOUND | EXAMPLE.SNOW_DATA | EXAMPLE | | ACCOUNTADMIN | | | | 2022-08-18 12:02:29.625 -0700 | OUTBOUND | ALFALFA_DB.SNOW_DATA | ALFALFA_DB | AB12345, YZ23456 | ACCOUNTADMIN | | | | 2022-08-18 14:02:40.625 -0700 | OUTBOUND | SALES_DB.SNOWIER_SHARE | SALES_DB | | ACCOUNTADMIN | | | | 2022-08-20 15:03:50.625 -0700 | OUTBOUND | SALES_DB.SNOWY_SHARE | SALES_DB | | ACCOUNTADMIN | | | | 2022-08-18 13:04:29.625 -0700 | OUTBOUND | SALES_DB.SNOW_SHARE | SALES_DB | AB12345 | ACCOUNTADMIN | | | +-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+Copy