カテゴリ:

データベース、スキーマ、共有 DDL

SHOW SHARES

システムで利用可能なすべての 共有 をリストします。

  • アカウントで(プロバイダーとして)作成されたアウトバウンド共有(コンシューマーへ)。

  • アカウントが使用できるインバウンド共有(プロバイダーから)。

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

CREATE SHAREDESCRIBE SHAREDROP SHARE

構文

SHOW SHARES [ LIKE '<pattern>' ]

パラメーター

LIKE 'パターン'

オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字(% および _)をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

例えば、次のパターンは同じ結果を返します。

...LIKE '%testing%' ...
...LIKE '%TESTING%' ...

使用上の注意

  • ACCOUNTADMIN 以外のロールを使用してこのコマンドを実行すると、空の結果が返されます。

  • このコマンドは、実行中のウェアハウスを必要としません。

  • コマンドは、コマンドを実行するために使用されるロールのアクセス権によって決定された通り、指定されたオブジェクトタイプに対して 最大 10Kのレコードを返します。フィルタが適用されていても、10Kの制限を超えるレコードは返されません。

    10Kを超えるレコードが存在する結果を表示するには、 情報スキーマ で対応するビュー(存在する場合)をクエリします。

  • このコマンドの出力を後処理するには、 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 |                                        |
+-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+