SHOW IMAGE REPOSITORIES¶

Listet die Image-Repositorys auf, für die Sie Zugriffsrechte haben.

Mit diesem Befehl können Sie die Repositorys in der aktuellen Datenbank und im aktuellen Schema für die Sitzung, für eine bestimmte Datenbank oder ein bestimmtes Schema oder für Ihr gesamtes Konto auflisten.

Siehe auch:: CREATE IMAGE REPOSITORY, DROP IMAGE REPOSITORY

Syntax¶

SHOW IMAGE REPOSITORIES [ LIKE '<pattern>' ]
           [ IN
                {
                  ACCOUNT                  |

                  DATABASE                 |
                  DATABASE <database_name> |

                  SCHEMA                   |
                  SCHEMA <schema_name>     |
                  <schema_name>
                }
           ]

Copy

Parameter¶

LIKE 'pattern'

Filtert optional die Befehlsausgabe nach dem Objektnamen. Der Filter verwendet einen Musterabgleich 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%' ...

. Standard: Kein Wert (die Ausgabe wird nicht gefiltert).

[ IN ... ]

Gibt optional den Geltungsbereich des Befehls an. Geben Sie eine der folgenden Optionen an:

ACCOUNT

Gibt Datensätze für das gesamte Konto zurück.

DATABASE, . DATABASE db_name

Gibt Datensätze für die aktuell verwendete Datenbank oder eine angegebene Datenbank (db_name) zurück.

Wenn Sie DATABASE ohne db_name angeben und aktuell keine Datenbank in Verwendung ist, hat das Schlüsselwort keine Auswirkungen auf die Ausgabe.

SCHEMA, . SCHEMA schema_name, . schema_name

Gibt Datensätze für das aktuell verwendete Schema oder ein angegebenes Schema (schema_name) zurück.

SCHEMA ist optional, wenn aktuell eine Datenbank in Verwendung ist oder wenn Sie für schema_name den vollqualifizierten Schemanamen (z. B. db.schema) angeben.

Wenn aktuell keine Datenbank in Verwendung ist, hat die Angabe von SCHEMA keine Auswirkungen auf die Ausgabe.

Standard: Abhängig davon, ob für die Sitzung aktuell eine Datenbank in Verwendung ist:

Datenbank: DATABASE ist der Standardwert (d. h. der Befehl gibt die Objekte zurück, für die Sie Berechtigungen zum Anzeigen in der Datenbank haben).
Keine Datenbank: ACCOUNT ist der Standardwert (d. h. der Befehl gibt die Objekte zurück, für die Sie Berechtigungen zum Anzeigen in Ihrem Konto haben).

Anforderungen an die Zugriffssteuerung¶

Jede der folgenden Repository-Berechtigungen gewährt die Berechtigung, Repositorys in der SHOW IMAGE REPOSITORIES-Ausgabe anzuzeigen. Wenn Sie keine dieser Berechtigungen haben, gibt SHOW IMAGE REPOSITORIES ein leeres Ergebnis zurück.

Berechtigung	Objekt	Anmerkungen
READ	Image-Repository	Um ein Image aus einem Repository abzurufen, erfordert die Rolle diese Berechtigung.
WRITE	Image-Repository	Um ein Image in ein Repository zu übertragen, erfordert die Rolle diese Berechtigung.
OWNERSHIP	Image-Repository	Um ein Repository zu erstellen, erfordert die Rolle diese Berechtigung.

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Ausgabe¶

Die Befehlsausgabe enthält Eigenschaften und Metadaten des Repository in den folgenden Spalten:

Spalte	Beschreibung
`created_on`	Datum und Uhrzeit der Erstellung des Repository.
`database_name`	Datenbank, in dem das Repository erstellt wurde.
`schema_name`	Schema, in dem das Repository erstellt wurde.
`repository_url`	URL des Image-Repository. Sie benötigen diese URL, um Images in ein Repository zu übertragen (zum Beispiel `docker push`) oder aus einem Repository abzurufen (zum Beispiel `docker pull`).
`owner`	Rolle, der das Repository gehört.
`owner_role_type`	Typ der Rolle, die Eigentümer des Objekts ist, entweder ROLE oder DATABASE_ROLE. Beachten Sie, dass Snowflake NULL zurückgibt, wenn Sie das Objekt löschen, da es keine Eigentümerrolle für ein gelöschtes Objekt gibt.
`comment`	Beschreibung für das Repository.

Nutzungshinweise¶

Spalten, die mit dem Präfix is_ beginnen, geben entweder Y (ja) oder N (nein) zurück.
Für die Ausführung 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.

Beispiele¶

In den folgenden beiden Beispielen werden Repositorys in der aktuellen Datenbank und im aktuellen Schema aufgelistet:

SHOW IMAGE REPOSITORIES;

Copy

SHOW IMAGE REPOSITORIES IN SCHEMA;

Copy

Das folgende Beispiel listet Repositorys in der aktuellen Datenbank und dem angegebenen Schema auf:

SHOW IMAGE REPOSITORIES IN SCHEMA sc1;

Copy

Das folgende Beispiel listet Repositorys in der aktuellen Datenbank und alle Schemas auf:

SHOW IMAGE REPOSITORIES IN DATABASE;

Copy

Das folgende Beispiel listet Repositorys in der angegebenen Datenbank und alle Schemas auf:

SHOW IMAGE REPOSITORIES IN DATABASE db1;

Copy

Das folgende Beispiel listet Repositorys im aktuellen Konto auf (alle Datenbanken und alle Schemas):

SHOW IMAGE REPOSITORIES IN ACCOUNT;

Copy

Beispielausgabe:

+-------------------------------+---------------------+---------------+-------------+-----------------------------------------------------------------------------------------------------------------+-----------+-----------------+---------+
| created_on                    | name                | database_name | schema_name | repository_url                                                                                                  | owner     | owner_role_type | comment |
|-------------------------------+---------------------+---------------+-------------+-----------------------------------------------------------------------------------------------------------------+-----------+-----------------+---------|
| 2023-05-09 14:27:19.459 -0700 | TUTORIAL_REPOSITORY | TUTORIAL_DB   | DATA_SCHEMA | orgname-acctname.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository | TEST_ROLE | ROLE            |         |
+-------------------------------+---------------------+---------------+-------------+-----------------------------------------------------------------------------------------------------------------+-----------+-----------------+---------+