Kategorien:

DDL für Datenbanken, Schemas und Freigaben

SHOW SHARES

Listet alle im System verfügbaren Freigaben auf:

  • Ausgehende Freigaben (für Verbraucher), die in Ihrem Konto (als Anbieter) erstellt wurden.

  • Eingehende Freigaben (von Anbietern), die für Ihr Konto zur Verfügung stehen.

Siehe auch:

CREATE SHARE, ALTER SHARE, DROP SHARE, DESCRIBE SHARE

Syntax

SHOW SHARES [ LIKE '<pattern>' ]

Parameter

LIKE 'Muster'

Filtert die Befehlsausgabe nach dem Objektnamen. Der Filter verwendet eine Mustererkennung ohne Berücksichtigung der Groß-/Kleinschreibung, aber mit Unterstützung von SQL-Platzhalterzeichen (% und _).

Die folgenden Muster geben beispielsweise die gleichen Ergebnisse zurück:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

Nutzungshinweise

  • Der Befehl listet nur Freigaben für Benutzer mit einer Rolle auf, die über die Berechtigung IMPORT SHARE verfügt:

    Bemerkung

    Die Ausführung dieses Befehls ohne ausreichende Berechtigungen liefert leere Ergebnisse.

  • Zum Ausführen des Befehls ist kein aktives Warehouse erforderlich.

  • Der Befehl gibt maximal 10.000 Datensätze für den angegebenen Objekttyp zurück, wie durch die Zugriffsrechte für die Rolle vorgegeben, die zur Ausführung des Befehls verwendet wird. Datensätze, die über dem Limit von 10.000 liegen, werden nicht zurückgegeben, selbst wenn ein Filter angewendet wird.

    Um Ergebnisse anzuzeigen, für die mehr als 10.000 Datensätze existieren, fragen Sie die entsprechende Ansicht (falls vorhanden) in der Datei Snowflake Information Schema ab.

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

Ausgabe

  • Die Spalte kind zeigt Folgendes an:

    • INBOUND gibt an, dass die Freigabe für Ihr Konto zur Verfügung steht (d. h. Sie können eine Datenbank aus der Freigabe erstellen).

    • OUTBOUND zeigt an, dass Ihr Konto Daten für andere Konten freigibt und diese Freigabe in Ihrem Konto erstellt wurde.

  • Wenn bei OUTBOUND-Freigaben Konten zur Freigabe hinzugefügt wurden, werden diese Konten in der Spalte to angezeigt. In dieser Spalte werden maximal drei Konten angezeigt. Es gibt jedoch keine feste Begrenzung für die Anzahl der Konten, die einer Freigabe hinzugefügt werden können.

Beispiele

Zeigen Sie alle Freigaben an, die in Ihrem Konto erstellt wurden oder für Ihr Konto verfügbar sind:

SHOW SHARES;

+-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+
| created_on                    | kind     | name                    | database_name         | to               | owner        | comment                                |
|-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------|
| 2016-07-09 19:18:09.821 -0700 | INBOUND  | SFC_SAMPLES.SAMPLE_DATA | SNOWFLAKE_SAMPLE_DATA |                  |              | Sample data sets provided by Snowflake |
| 2017-06-15 17:02:29.625 -0700 | OUTBOUND | AB67890.SALES_S         | SALES_DB              | XY12345, YZ23456 | ACCOUNTADMIN |                                        |
+-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+