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

Verbraucher (eingehende Freigabe)

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

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 den Befehl Pipe-Operator (->>) oder die RESULT_SCAN-Funktion verwenden. Beide Konstrukte behandeln die Ausgabe als Resultset, das Sie abfragen können.

    Sie können zum Beispiel den Pipe-Operator oder die RESULT_SCAN-Funktion verwenden, um bestimmte Spalten aus der SHOW-Befehlsausgabe auszuwählen oder die Zeilen zu filtern.

    Wenn Sie sich auf die Ausgabespalten beziehen, verwenden Sie Bezeichner mit doppelten Anführungszeichen für die Spaltennamen. Um beispielsweise die Ausgabespalte type auszuwählen, geben Sie SELECT "type" an.

    Sie müssen Bezeichner in doppelten Anführungszeichen verwenden, da die Ausgabespaltennamen für SHOW-Befehle in Kleinbuchstaben geschrieben sind. Die doppelten Anführungszeichen stellen sicher, dass die Spaltennamen in der SELECT-Liste oder WHERE-Klausel den Spaltennamen in der SHOW-Befehlsausgabe entsprechen, die gescannt wurde.

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

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

Sprache: Deutsch