DESCRIBE SHARE¶

Beschreibt die Datenobjekte, die in einer Freigabe enthalten sind.

DESCRIBE kann mit DESC abgekürzt werden.

Siehe auch:: DROP SHARE, ALTER SHARE, CREATE SHARE, SHOW SHARES

Syntax¶

Anbieter (ausgehende Freigabe)

DESC[RIBE] SHARE <name>

Verbraucher (eingehende Freigabe)

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

Parameter¶

name: Gibt den Bezeichner für die zu beschreibende, ausgehende Freigabe an. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.
provider_account.share_name: Gibt den vollqualifizierten Bezeichner für die zu beschreibende, eingehende Freigabe an.

Nutzungshinweise¶

Nur die ACCOUNTADMIN-Rolle hat die Berechtigung, eine Freigabe zu beschreiben. Wenn Sie diesen Befehl mit einer anderen Rolle als ACCOUNTADMIN ausführen, wird ein Fehler ausgegeben.

Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.

Ausgabe¶

Die Ausgabe des Befehls ist unterschiedlich, je nachdem, ob Sie ein Anbieter oder ein Verbraucher sind:
- Bei Anbietern werden die Namen der Objekte in der Freigabe mit dem Datenbanknamen vorangestellt.
- Bei Verbrauchern werden die Namen der Objekte in der Freigabe nur dann mit einem Datenbanknamen versehen, wenn eine Datenbank aus der Freigabe erstellt wurde. Wenn keine Datenbank aus der Freigabe erstellt wurde, wird den Objekten das Präfix <DB> vorangestellt.
Die Spalte kind in der Ausgabe zeigt den Typ der Objekte in der Freigabe an.

Beispiele¶

Zeigen Sie als Anbieter die Objekte in der sales_s-Freigabe an:

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 |
+----------+--------------------------------------+-------------------------------+

Zeigen Sie als Verbraucher die Objekte in der sales_s-Freigabe an, die vom Konto ab67890 bereitgestellt wird:

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 |
+----------+----------------------------------+---------------------------------+

In diesem Beispiel wurde noch keine Datenbank im Konto des Verbrauchers aus der sales_s-Freigabe erstellt.