カテゴリ:

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

DESCRIBE SHARE

共有 に含まれるデータオブジェクトについて説明します。

DESCRIBE は DESCに短縮できます。

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

ALTER SHARECREATE SHARESHOW SHARES

構文

プロバイダー(アウトバウンド共有)

DESC[RIBE] SHARE <name>

コンシューマー(インバウンドシェア)

DESC[RIBE] SHARE <provider_account>.<share_name>

パラメーター

名前

記述するアウトバウンド共有の識別子を指定します。識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。

プロバイダーアカウント.共有名

記述するインバウンド共有の完全修飾識別子を指定します。

使用上の注意

  • ACCOUNTADMIN ロールのみが、共有を説明する権限を持っています。ACCOUNTADMIN 以外のロールでこのコマンドを実行すると、エラーが返されます。

  • このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

出力

  • コマンドの出力は、プロバイダーであるかコンシューマーであるかによって異なります。

    • プロバイダーの場合、共有内のオブジェクトの名前の前にデータベース名が付けられます。

    • コンシューマの場合、共有からデータベースが作成されている場合にのみ、共有内のオブジェクトの名前にデータベース名がプレフィックスとして追加されます。共有からデータベースが作成されていない場合、オブジェクトの先頭には <DB> が付きます。

  • 出力の kind 列には、共有内のオブジェクトのタイプが表示されます。

プロバイダーとして、 sales_s 共有内のオブジェクトを表示します。

DESC SHARE sales_s;

+----------+--------------------------------------+-------------------------------+
| kind     | name                                 | shared_on                     |
|----------+--------------------------------------+-------------------------------|
| DATABASE | SALES_DB                             | 2017-06-15 17:03:16.642 -0700 |
| SCHEMA   | SALES_DB.AGGREGATES_EULA             | 2017-06-15 17:03:16.790 -0700 |
| TABLE    | SALES_DB.AGGREGATES_EULA.AGGREGATE_1 | 2017-06-15 17:03:16.963 -0700 |
+----------+--------------------------------------+-------------------------------+

コンシューマーとして、アカウント ab67890 が提供する sales_s 共有内のオブジェクトを表示します。

DESC SHARE ab67890.sales_s;

+----------+----------------------------------+---------------------------------+
| kind     | name                             | shared_on                       |
|----------+----------------------------------+---------------------------------|
| DATABASE | <DB>                             | Thu, 15 Jun 2017 17:03:16 -0700 |
| SCHEMA   | <DB>.AGGREGATES_EULA             | Thu, 15 Jun 2017 17:03:16 -0700 |
| TABLE    | <DB>.AGGREGATES_EULA.AGGREGATE_1 | Thu, 15 Jun 2017 17:03:16 -0700 |
+----------+----------------------------------+---------------------------------+

この例では、 sales_s 共有からコンシューマーのアカウントにデータベースがまだ作成されていません。