DESCRIBE SHARE¶
共有 に含まれるデータオブジェクトについて説明します。
DESCRIBE は DESCに短縮できます。
- こちらもご参照ください。
構文¶
プロバイダー(アウトバウンド共有)
DESC[RIBE] SHARE <name>
Copy
コンシューマー(インバウンドシェア)
DESC[RIBE] SHARE <provider_account>.<share_name>
Copy
パラメーター¶
name
記述するアウトバウンド共有の識別子を指定します。識別子にスペースまたは特殊文字が含まれる場合、文字列全体を二重引用符で囲む必要があります。二重引用符で囲まれた識別子も大文字と小文字が区別されます。
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 | +----------+--------------------------------------+-------------------------------+Copy
コンシューマーとして、アカウント 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 | +----------+----------------------------------+---------------------------------+Copyこの例では、
sales_s
共有からコンシューマーのアカウントにデータベースがまだ作成されていません。