Release-Richtlinie für eine App festlegen

Unter diesem Thema wird beschrieben, wie Sie die Release-Richtlinie für ein Anwendungspaket festlegen.

Allgemeine Informationen zu Release-Richtlinien

Mit Release-Richtlinien wird festgelegt, welche Version der App einem Verbraucher zur Verfügung gestellt wird, wenn dieser die App installiert. Release-Richtlinien werden im Anwendungspaket mit dem Befehl ALTER APPLICATION PACKAGE definiert.

Es gibt zwei Typen von Release-Richtlinien:

Kundenspezifische Release-Richtlinie

Der Anbieter kann festlegen, welche Version einer Anwendung von bestimmten Snowflake-Konten installiert wird. Weitere Informationen dazu finden Sie unter Hinzufügen einer kundenspezifischen Release-Richtlinie.

Standard-Release-Richtlinie

Gibt die Version und den Patch an, die bei der Installation einer Snowflake Native App für alle Verbraucher gelten. Wenn ein Anbieter die Versionen V1 und V2 einer Anwendung erstellt, wird durch die Standard-Release-Richtlinie auf V2 sichergestellt, dass ein Verbraucher bei der Installation der Snowflake Native App die Version V2 installiert.

Weitere Informationen dazu finden Sie unter Standard-Release-Richtlinie festlegen.

Wenn ein Anbieter die Versionen V2 und V3 einer Anwendung erstellt, kann er V2 als Standard-Release festlegen und eine benutzerdefinierte Release-Richtlinie erstellen, damit V3 nur für bestimmte Konten freigegeben wird. Ein Anbieter kann auch die Version V3 der Anwendung vor deren Veröffentlichung erst einmal nur für ein Testkonto freigeben.

Bemerkung

Wenn Sie sowohl eine Standard- als auch eine kundenspezifische Release-Richtlinie angeben, hat die kundenspezifische Release-Richtlinie immer Vorrang. Im obigen Beispiel können Verbraucherkonten, die in der kundenspezifischen Release-Richtlinie angegeben sind, nur Version V3 der Anwendung installieren.

Sie müssen erst eine Release-Richtlinie in einem Anwendungspaket definieren, bevor Sie folgende Aufgaben ausführen können:

  • Erstellen eines öffentlichen Freigabeangebots mit dem Anwendungspaket als Dateninhalt

  • Installieren einer Snowflake Native App in einem Verbraucherkonto

Erforderliche Berechtigungen zum Festlegen der Release-Richtlinie

Für das Festlegen einer Release-Richtlinie muss der Anbieter die Berechtigung MANAGE RELEASES oder die Eigentümerschaft an dem Anwendungspaket haben.

GRANT MANAGE RELEASES ON APPLICATION PACKAGE hello_snowflake_package
  TO ROLE release_mgr;
Copy

Standard-Release-Richtlinie festlegen

Verwenden Sie zum Festlegen der Standard-Release-Richtlinie den Befehl ALTER APPLICATION PACKAGE mit SET DEFAULT RELEASE DIRECTIVE, wie im folgenden Beispiel gezeigt:

ALTER APPLICATION PACKAGE hello_snowflake_package
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = v1_0
  PATCH = 2;
Copy

Um die Standard-Release-Richtlinie für ein Anwendungspaket zu aktualisieren, führen Sie den Befehl ALTER APPLICATION PACKAGE erneut mit SET DEFAULT RELEASE DIRECTIVE aus, wobei Sie neue Werte für VERSION und PATCH angeben.

Setzen und Aktualisieren einer kundenspezifischen Release-Richtlinie

Eine kundenspezifische Release-Richtlinie setzen

Um eine kundenspezifische Release-Richtlinie hinzuzufügen, verwenden Sie den Befehl ALTER APPLICATION PACKAGE mit SET RELEASE DIRECTIVE. Verwenden Sie die Klausel ACCOUNTS, um die Konten anzugeben, für die diese Release-Richtlinie gelten soll. Beispiel:

ALTER APPLICATION PACKAGE hello_snowflake_package
  SET RELEASE DIRECTIVE hello_snowflake_package_custom
  ACCOUNTS = (CONSUMER_ORG.CONSUMER_ACCOUNT)
  VERSION = v1_0
  PATCH = 0;
Copy

Kundenspezifische Release-Richtlinie aktualisieren

Um die Version oder den Patch für eine kundenspezifische Release-Richtlinie zu aktualisieren, verwenden Sie den Befehl ALTER APPLICATION PACKAGE mit MODIFY RELEASE DIRECTIVE wie im folgenden Beispiel gezeigt:

ALTER APPLICATION PACKAGE hello_snowflake_package
  MODIFY RELEASE DIRECTIVE hello_snowflake_package_custom
  VERSION = v1_0
  PATCH = 0;
Copy

Sie können jedoch nicht die Konten ändern, die der Release-Richtlinie zugeordnet sind. Um die Organisation und das Konto zu ändern, die einer Release-Richtlinie zugeordnet sind, gehen Sie wie folgt vor:

  1. Entfernen Sie die Release-Richtlinie aus dem Anwendungspaket, indem Sie den Befehl ALTER APPLICATION PACKAGE mit UNSET RELEASE DIRECTIVE ausführen.

  2. Fügen Sie die Release-Richtlinie wieder zum Anwendungspaket hinzu, indem Sie den Befehl ALTER APPLICATION PACKAGE mit SET RELEASE DIRECTIVE ausführen und dabei mit der Klausel ACCOUNTS die Liste der Konten angeben.

Bemerkung

Wenn Sie Organisation und Konto ändern, die mit der Release-Richtlinie verbunden sind, fügen Sie die neue Release-Richtlinie unmittelbar nach dem Entfernen der alten hinzu. Wenn Sie dies nicht tun, werden die installierten Apps für die Konten, die der kundenspezifischen Release-Richtlinie zugewiesen sind, auf die Standard-Release-Richtlinie zurückgesetzt.

Kundenspezifische Release-Richtlinie entfernen

Um eine kundenspezifische Release-Richtlinie aus einem Anwendungspaket zu entfernen, verwenden Sie den Befehl ALTER APPLICATION PACKAGE mit UNSET RELEASE DIRECTIVE wie im folgenden Beispiel gezeigt:

ALTER APPLICATION PACKAGE hello_snowflake_package
  UNSET RELEASE DIRECTIVE hello_snowflake_package_custom;
Copy

Testen einer Anwendung basierend einer Release-Richtlinie

Wenn Sie eine Anwendung aus einem Anwendungspaket im Entwicklungsmodus installieren, werden die Version und der Patch explizit angegeben. Dies gilt nicht, wenn die Anwendung mit dem folgenden Befehl installiert wird:

CREATE APPLICATION hello_snowflake
  FROM APPLICATION PACKAGE hello_snowflake_package
Copy

In diesem Fall bestimmt die Release-Richtlinie die Version, die bei der Ausführung dieses Befehls installiert wird.

Release-Richtlinie für ein Anwendungspaket anzeigen

Um die Release-Richtlinien mithilfe von SQL anzuzeigen, führen Sie den Befehl SHOW RELEASE DIRECTIVES wie im folgenden Beispiel gezeigt aus:

SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE hello_snowflake_package;
Copy
Sprache: Deutsch