ALTER APPLICATION PACKAGE … MODIFY RELEASE CHANNEL

Ändert die für ein bestehendes Anwendungspaket definierten Release-Kanäle. Verwenden Sie diesen Befehl, um einen Release-Kanal zu ändern, die Version oder den Patch zu ändern, die einem Release-Kanal zugewiesen ist, oder die Release-Richtlinie für einen Release-Kanal festzulegen.

Bemerkung

Die Syntax unter diesem Thema gilt nur für Anwendungspakete, die Release-Kanäle verwenden. Weitere Informationen dazu finden Sie unter Veröffentlichen einer App über Release-Kanäle. Weitere Informationen zum Festlegen der Release-Richtlinie für ein Anwendungspaket, das keine Release-Kanäle verwendet, finden Sie unter ALTER APPLICATION PACKAGE … RELEASE DIRECTIVE.

Siehe auch:

ALTER APPLICATION PACKAGE , ALTER APPLICATION PACKAGE … VERSION, ALTER APPLICATION PACKAGE … RELEASE DIRECTIVE SHOW RELEASE DIRECTIVES

Syntax

ALTER APPLICATION PACKAGE <name>
  MODIFY RELEASE CHANNEL <release_channel>
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = <version_identifier>
  PATCH = <patch_num>
  [ UPGRADE_AFTER = '<timestamp>' ]
  [ UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE } ]
  [ UPGRADE_DEADLINE = '<timestamp>' ]

ALTER APPLICATION PACKAGE <name>
  MODIFY RELEASE CHANNEL <release_channel>
  SET RELEASE DIRECTIVE <release_directive>
  ACCOUNTS = ( <organization_name>.<account_name> [ , <organization_name>.<account_name> , ... ] )
  VERSION = <version_identifier>
  PATCH = <patch_num>
  [ UPGRADE_AFTER = '<timestamp>' ]
  [ UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE } ]
  [ UPGRADE_DEADLINE = '<timestamp>' ]

ALTER APPLICATION PACKAGE <name>
 MODIFY RELEASE CHANNEL <release_channel>
 MODIFY RELEASE DIRECTIVE <release_directive>
 VERSION = <version_identifier>
 PATCH = <patch_num>
 [ UPGRADE_AFTER = '<timestamp>' ]
 [ UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE } ]
 [ UPGRADE_DEADLINE = '<timestamp>' ]

ALTER APPLICATION PACKAGE <name>
  MODIFY RELEASE CHANNEL <release_channel>
  UNSET RELEASE DIRECTIVE <release_directive>

Parameter

name

Gibt den Bezeichner des Anwendungspakets an. Wenn der Bezeichner Leerzeichen, Sonderzeichen oder Zeichen in Groß-/Kleinschreibung enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen eingeschlossen werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

MODIFY RELEASE CHANNEL release_channel

Gibt den Release-Kanal an, für den diese Release-Richtlinie gelten soll. Wenn nicht angegeben, gilt die Release-Richtlinie für alle Release-Kanäle.

Folgende Werte werden unterstützt:

  • ALPHA

  • QA

  • DEFAULT

Weitere Informationen über Release-Kanäle finden Sie unter Veröffentlichen einer App über Release-Kanäle.

VERSION = version_identifier . PATCH = patch_num

Ändert die Version und den Patch-Level der angegebenen kundenspezifischen Freigaberichtlinie.

SET

Gibt eine (oder mehrere) Eigenschaften an, die für das Anwendungspaket festgelegt werden sollen (getrennt durch Leerzeichen, Kommas oder Neue-Zeile-Zeichen). Weitere Informationen zu den Eigenschaften, die Sie festlegen können, finden Sie unter CREATE APPLICATION.

DEFAULT RELEASE DIRECTIVE VERSION = version_identifier PATCH = patch_num

Legt die Version und den Patch-Level des Anwendungspakets fest, die standardmäßig für Verbraucher installiert werden sollen.

RELEASE DIRECTIVE release_directive . ACCOUNTS = ( organization_name.account_name [ , organization_name.account_name , ... ] ) . VERSION = version_identifier . PATCH = patch_num

Erstellt eine kundenspezifische Freigaberichtlinie für die angegebenen Konten.

Verwenden Sie die ACCOUNTS-Klausel, um die Liste der Konten anzugeben, für die diese Release-Richtlinie gelten soll.

Verwenden Sie die Klauseln VERSION und PATCH, um den Bezeichner der Version und die Patchnummer anzugeben, die für diese Konten installiert werden sollen.

UPGRADE_AFTER = 'timestamp'

Legt das Datum und die Uhrzeit fest, wann der automatische Upgrade-Prozess beginnt. Verbraucher können eine Anwendung vor diesem Datum manuell auf eine neue Version oder einen Patch aktualisieren.

Dieser Wert kann jedes gültige Datums- und Zeitformat sein.

Snowflake-Logo in Schwarz (ohne Text) Vorschau-Feature – Offen

Verfügbar bei allen Konten.

UPGRADE_IN_MAINTENANCE_WINDOW = { TRUE | FALSE }

Wenn auf TRUE gesetzt, respektieren die Upgrades die Wartungsrichtlinien der Verbraucher. Anstatt ein sofortiges Upgrade durchzuführen, wird das Upgrade bis zum nächsten Wartungsfenster des Verbrauchers oder bis zum Erreichen der Upgrade-Frist verschoben, je nachdem, was zuerst eintritt.

Wenn dieser Parameter TRUE lautet, ist der Parameter UPGRADE_DEADLINE erforderlich.

Sie können die Parameter UPGRADE_AFTER und UPGRADE_IN_MAINTENANCE_WINDOW gleichzeitig festlegen. Wenn Sie versuchen, beides einzustellen, schlägt der Befehl mit einem Fehler fehl.

Weitere Informationen dazu finden Sie unter Verbraucherkontrollierte Wartungsrichtlinien: Anbieterhandbuch.

UPGRADE_DEADLINE = 'timestamp'

Erforderlich, wennUPGRADE_IN_MAINTENANCE_WINDOW auf TRUE gesetzt ist. Gibt die Frist an, bis zu der das Upgrade abgeschlossen sein muss. Nach diesem Zeitpunkt aktualisiert das System die Anwendung automatisch, unabhängig von den Wartungsrichtlinien des Verbrauchenden.

Legen Sie für die Frist ein Datum und eine Uhrzeit fest, die den Verbrauchern genügend Zeit lassen, das Upgrade innerhalb ihrer Wartungsfenster abzuschließen.

UNSET

Gibt eine (oder mehrere) Eigenschaften und/oder Sitzungsparameter an, deren Einstellungen für das Anwendungspaket aufgehoben werden sollen, wodurch sie auf die Standardwerte zurückgesetzt werden.

UNSET RELEASE DIRECTIVE release_directive

Entfernt die angegebene kundenspezifische Freigaberichtlinie aus dem Anwendungspaket.

Nutzungshinweise

  • Für das Ändern der Freigaberichtlinie ist die OWNERSHIP-Berechtigung für die Anwendung oder die globale Berechtigung MANAGE VERSIONS erforderlich.

  • Wenn Sie die Werte für die optionalen Eigenschaften nicht angeben, verwendet der Befehl die in der Manifest-Datei der Anwendung angegebenen Werte.

  • Wenn Sie Werte für die Eigenschaften im Befehl und in der Manifest-Datei der Anwendung angeben, haben die im Befehl angegebenen Werte Vorrang.

Beispiele

Das folgende Beispiel fügt die Version V1 zum Standard-Release-Kanal hinzu:

ALTER APPLICATION PACKAGE my_app_package
  MODIFY RELEASE CHANNEL DEFAULT
  ADD VERSION V1;

+---------------------------------------------------------------------------------------------------------+
| status                                                                                                  |
|---------------------------------------------------------------------------------------------------------|
| Version V1 added to release channel DEFAULT in application package my_app_package                       |
+---------------------------------------------------------------------------------------------------------+

Im folgenden Beispiel wird die Standard-Release-Richtlinie des Standard-Release-Kanals geändert, um die Version auf V1 und den Patch auf 0 zu setzen:

ALTER APPLICATION PACKAGE my_app_package
  MODIFY RELEASE CHANNEL DEFAULT
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = V1
  PATCH=0;

+---------------------------------------------------------------------------------------------------------+
| status                                                                                                  |
|---------------------------------------------------------------------------------------------------------|
| Version V1 added to release channel DEFAULT in application package my_app_package                       |
+---------------------------------------------------------------------------------------------------------+

ALTER APPLICATION PACKAGE my_app_package
  MODIFY RELEASE CHANNEL ALPHA
  ADD ACCOUNTS=(PM.CONNECTORS);

+---------------------------------------------------------------------------------------+---------+-------+
| status                                                                                | version | patch |
|---------------------------------------------------------------------------------------+---------+-------|
| TBD                                                                                   |         |       |
+---------------------------------------------------------------------------------------+---------+-------+