SHOW RELEASE DIRECTIVES

Listet die für ein Anwendungspaket definierten Release-Richtlinien auf.

Die Ausgabe gibt Metadaten und Eigenschaften zu den Freigaberichtlinien eines Anwendungspakets lexikografisch nach Namen geordnet zurück. Dies muss beachtet werden, wenn Sie die Ergebnisse mit den bereitgestellten Filtern filtern möchten.

Siehe auch:

ALTER APPLICATION PACKAGE, CREATE APPLICATION PACKAGE, DROP APPLICATION PACKAGE, SHOW APPLICATION PACKAGES

Syntax

SHOW RELEASE DIRECTIVES [ LIKE '<pattern>' ]
  IN APPLICATION PACKAGE <name>
  [ FOR RELEASE CHANNEL <release_channel> ]
Copy

Parameter

name

Gibt den Bezeichner des Anwendungspakets an.

LIKE 'pattern'

Filtert optional die Befehlsausgabe nach dem im Anwendungspaket angegebenen Versionsnamen. 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 '%v1%' ...
... LIKE '%V1%' ...

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

FOR RELEASE CHANNEL release_channel

Gibt nur die Release-Richtlinien zurück, die für die angegebenen Release-Kanäle definiert sind.

Ausgabe

Die Befehlsausgabe enthält Eigenschaften und Metadaten zu den Release-Richtlinie in den folgenden Spalten:

Spalte

Beschreibung

name

Gibt den Namen der Release-Richtlinie an. Der Name der Standard-Release-Richtlinie ist DEFAULT.

target_type

Gibt den Typ des Ziels für die Freigaberichtlinie an. Die folgenden Werte sind möglich:

  • DEFAULT

  • ACCOUNT

target_name

Gibt den Namen der Organisation oder des Kontos an. Der Wert der Standard-Release-Richtlinie ist immer NULL.

created_on

Gibt den Zeitstempel für den Zeitpunkt der Erstellung der Release-Richtlinie an.

version

Gibt das Versionsliteral der Anwendung an, falls zutreffend; Wenn nicht, ist der Wert NULL.

patch

Gibt die Patchnummer der Anwendungsversion an, falls zutreffend. Wenn nicht, lautet der Wert NULL.

modified_on

Gibt den Zeitstempel für den Zeitpunkt an, an dem die Release-Richtlinie zuletzt geändert wurde, oder NULL, wenn sie nicht geändert wurde.

active_regions

Gibt die Liste der Snowflake Regionen an, in denen sich die Freigaberichtlinie auf Upgrades auswirken darf. Dieser Wert wird ignoriert, wenn RELEASE_STATUS HOLDING ist.

pending_regions

Gibt die Liste der Snowflake-Regionen an, auf die die Release-Richtlinie in Zukunft angewendet werden soll. Der Upgrade-Fortschritt in aktiven Regionen wird über einen bestimmten Zeitraum überwacht, bevor neue Regionen aktiviert werden.

release_status

Gibt den aktuellen Status des Releases an. Die folgenden Werte sind möglich:

  • IN_PROGRESS: In der Auflistung ACTIVE_REGIONS werden die Upgrades fortgesetzt.

  • HOLDING: Upgrades werden vorübergehend ausgesetzt.

  • DEPLOYED: Upgrades sind in allen Regionen erlaubt, in denen die App installiert ist.

deployed_on

Gibt die Uhrzeit und das Datum an, an dem die Freigaberichtlinie bereitgestellt wurde. Wenn während der Bereitstellung zu viele Zielregionen als problembehaftet identifiziert werden, wechselt die Freigaberichtlinie vorübergehend zu HOLDING.

release_channel

Gibt den Release-Kanal an, zu dem die Release-Richtlinie gehört.

Nutzungshinweise

  • Dieser Befehl erfordert die OWNERSHIP-Berechtigung, die MANAGE RELEASES-Berechtigung oder die MANAGE VERSIONS-Berechtigung für das Anwendungspaket.

  • Der Befehl gibt Ergebnisse für Release-Richtlinie zurück, die mit den Berechtigungen übereinstimmen, die der Rolle zugewiesen wurden, die diesen Befehl ausführt.

  • Für die Ausführung des Befehls ist kein aktives Warehouse erforderlich.

  • Der Befehl gibt nur Objekte zurück, für die der aktuellen Rolle des aktuellen Benutzers mindestens ein Zugriffsrecht zugewiesen wurde.

  • Das Zugriffsrecht MANAGE GRANTS gibt seinem Eigentümer implizit die Möglichkeit, jedes Objekt im Konto anzuzeigen. Standardmäßig haben nur der Kontoadministrator (Benutzer mit der Rolle ACCOUNTADMIN) und der Systemadministrator (Benutzer mit der Rolle SECURITYADMIN) die Berechtigung MANAGE GRANTS.

  • 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.

    For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

    When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

    You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.

Beispiele

SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE hello_snowflake_package;
Copy
+---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+
| name    | target_type | target_name                     | created_on                    | version | patch | modified_on                   | active_regions         | pending_regions          | release_status | deployed_on                   |
|---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+
| DEFAULT | DEFAULT     | NULL                            | 2023-04-02 14:55:17.304 -0700 | V2      |     0 | 2023-04-02 15:47:08.673 -0700 | PUBLIC.AWS_AP_SOUTH_1  | PUBLIC.AWS_AP_SOUTH_1    | IN PROGRESS    |                               |
| NEW_RD  | ACCOUNT     | [PROVIDER_DEV.PROVIDER_AWS]     | 2023-04-02 16:30:44.443 -0700 | V1      |     1 | 2023-04-03 07:10:42.428 -0700 | ALL                    |                          | DEPLOYED       | 2023-04-03 07:10:42.428 -0700 |         |
+---------+-------------+---------------------------------+-------------------------------+---------+-------+-------------------------------+------------------------+--------------------------+----------------+-------------------------------+