DESCRIBE SHARE¶
Beschreibt die Datenobjekte, die in einer Freigabe enthalten sind.
DESCRIBE kann mit DESC abgekürzt werden.
- Siehe auch:
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 wird den Namen der Objekte in der Freigabe der Datenbankname vorangestellt.
Bei Verbrauchern wird den Namen der Objekte in der Freigabe nur dann der Datenbankname vorangestellt, 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 | +----------+--------------------------------------+-------------------------------+Copy
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 | +----------+----------------------------------+---------------------------------+CopyIn diesem Beispiel wurde noch keine Datenbank im Konto des Verbrauchers aus der
sales_s
-Freigabe erstellt.