SHOW VERSIONS IN LISTING¶

Listet alle Freigabeangebotsversionen auf und liefert Details dazu.

Siehe auch:: CREATE LISTING, ALTER LISTING, DESCRIBE LISTING, DROP LISTING

Syntax¶

SHOW VERSIONS IN LISTING <name>
  [ LIMIT <rows> ]

Copy

Parameter¶

name

Gibt den Bezeichner des Freigabeangebots (Name) an. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelten Anführungszeichen eingeschlossen sind, wird ebenfalls zwischen Groß- und Kleinschreibung unterschieden.

Weitere Informationen finden Sie unter Anforderungen an Bezeichner.

LIMIT rows

Schränkt optional die maximale Anzahl der zurückgegebenen Zeilen ein und ermöglicht gleichzeitig die „Paginierung“ der Ergebnisse. Die tatsächliche Anzahl der zurückgegebenen Zeilen kann geringer sein als das angegebene Limit. Beispielsweise ist die Anzahl der vorhandenen Objekte geringer als das angegebene Limit.

Ausgabe¶

Die Ausgabe des Befehls enthält die folgenden Spalten, die die Eigenschaften und Metadaten des Objekts beschreiben:

Spalte	Beschreibung
`created_on`	Datum und Uhrzeit, wann die Version erstellt wurde.
`name`	Der vom System generierte Name der Version.
`alias`	Der vom Benutzer angegebene Alias der Version.
`location_url`	Vollständige URL der Version, gegen die Stagingbereichsoperationen durchgeführt werden können.
`is_default`	Bezeichner für die veröffentlichte Version des Freigabeangebots.
`is_live`	Gibt an, ob es sich bei der Version um eine Live-Version des Freigabeangebots handelt.
`is_first`	Gibt an, ob es sich bei der Version um die erste Version des Freigabeangebots handelt.
`is_last`	Gibt an, ob es sich bei der Version um die letzte Version des Freigabeangebots handelt.
`comment`	Optionale Kommentare für die Freigabeangebotsversion.
`source_location_url`	Die URL des Quellspeicherorts, von dem aus diese Version erstellt wurde.
`git_commit_hash`	Der Git-Commit-Hashwert, wenn die Version aus einer Git-Quelle erstellt wurde.

Anforderungen an die Zugriffssteuerung¶

Um Freigabeangebotsversionen anzuzeigen, müssen Sie eine Rolle verwenden, die über die Berechtigungen USAGE oder OWNERSHIP für das Freigabeangebot verfügt.

Nutzungshinweise¶

Der Wert für LIMIT rows darf 10000 nicht überschreiten. Wenn LIMIT rows nicht angegeben wird und das Resultset mehr als 10.000 Zeilen hat, führt der Befehl zu einem Fehler.

Um Ergebnisse anzuzeigen, für die mehr als 10.000 Datensätze vorhanden sind, fügen Sie entweder LIMIT rows ein oder fragen Sie die entsprechende Ansicht im Snowflake Information Schema ab.

Zur Weiterverarbeitung der Ausgabe dieses Befehls können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt. Sie können auch den Pipe-Operator verwenden, um die Ausgabe dieses Befehls abzufragen.

Beispiele¶

Zeigen Sie alle Versionen des Freigabeangebots MYLISTING an:

SHOW VERSIONS IN LISTING MYLISTING

Copy

+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
|             created_on            |             name             |             alias            |                  location_uri                 |     is_default     |       is_live      |      is_first      |       is_last      |                   comment                   |          source_location_uri          |             git_commit_hash           |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
|   2025-01-08 11:18:39.921 -0800   |                              |                              |  snow://listing/MYLISTING/versions/live/      |        FALSE       |        TRUE        |        FALSE       |       FALSE        |                                             |            @listingstage              |                                       |
|   2025-01-08 11:18:24.550 -0800   |        VERSION$2             |                              |  snow://listing/MYLISTING/versions/version$2/ |        TRUE        |        FALSE       |        FALSE       |       TRUE         |                                             |            @listingstage              |                                       |
|   2025-01-08 11:17:32.894 -0800   |        VERSION$1             |                              |  snow://listing/MYLISTING/versions/version$1/ |        FALSE       |        FALSE       |        TRUE        |       FALSE        |                                             |            @listingstage              |                                       |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+