ALTER APPLICATION PACKAGE … VERSION¶

Syntax¶

ALTER APPLICATION PACKAGE <name> ADD VERSION [ <version_identifier> ]
  USING <path_to_version_directory> [ LABEL = '<display_label>' ]

ALTER APPLICATION PACKAGE <name> DROP VERSION <version_identifier>

ALTER APPLICATION PACKAGE <name> ADD PATCH FOR VERSION [<version_identifier>]
  USING <path_to_version_directory> [ LABEL = '<display_label>' ]

Parameter¶

name

Gibt den Bezeichner für das zu ändernde Anwendungspaket 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.

ADD VERSION [ version_identifier ] USING path_to_version_directory

Fügt eine Version oder einen Patch unter Verwendung der Anwendungsdateien hinzu, die sich im Pfad zu einem durch path_to_version_directory angegebenen Stagingbereich befinden.

Sie können in version_identifier einen Identifikator für diese Version angeben. Wenn Sie in der Manifest-Datei keinen Wert für version_identifier angeben, müssen Sie einen version_identifier-Wert als Teil dieses Befehls angeben. Wenn Sie version_identifier als Teil dieses Befehls angeben, hat dieser Wert Vorrang vor dem version_identifier-Wert in der Manifest-Datei.

[ LABEL = 'display_label' ]

Sie können die LABEL-Klausel verwenden, um eine Bezeichnung für diese neue Version anzugeben. Diese Bezeichnung wird dem Verbraucher angezeigt. Wenn Sie die LABEL-Klausel weglassen, wird die in der Datei manifest.yml angegebene Bezeichnung verwendet.

DROP VERSION version_identifier

Löscht die Version mit dem angegebenen Versionsnamen.

Löscht eine Version mit dem angegebenen Versions-Identifikator. Eine Version kann nur dann gelöscht werden, wenn es keine Release-Richtlinie gibt, die sich auf diese Version beziehen. Das Löschen ist ein asynchroner Prozess, der abgeschlossen ist, wenn alle Anwendungsinstanzen erfolgreich auf die neuere Version aktualisiert wurden und kein Code der gelöschten Version mehr ausgeführt wird.

Verwenden Sie die Ansicht Ansicht APPLICATION_STATE, um den Status der Anwendungsinstanzen zu überwachen. Verwenden Sie den Befehl SHOW VERSIONS, um den Status der gelöschten Version zu überwachen.

ADD PATCH FOR VERSION version_identifier . USING path_to_version_directory [ LABEL = 'display_label' ]

Fügt einen Patch der angegebenen Version (version_identifier) unter Verwendung der Anwendungsdateien hinzu, die sich im angegebenen Pfad zu einem Stagingbereich (path_to_version_directory) befinden.

Sie können die LABEL-Klausel verwenden, um eine Bezeichnung für diesen neuen Patch anzugeben. Diese Bezeichnung wird dem Verbraucher angezeigt. Wenn Sie die LABEL-Klausel weglassen, wird die in der Datei manifest.yml angegebene Bezeichnung verwendet.

Nutzungshinweise¶

• Die Bezeichner der Versionen dürfen maximal 30 Zeichen lang sein.

• Eine einzelne Version kann bis zu 130 Patches haben.

• Für das Ändern der Version ist eine Rolle mit OWNERSHIP-Berechtigung für die Anwendung oder mit der globalen 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.

• Wenn zwei Versionen aktiv sind (wenn z. B. das Rollout der aktuellen Version noch nicht abgeschlossen wurde), führt das Hinzufügen einer neuen Version zu einem Fehler.

Beispiele¶

ALTER APPLICATION PACKAGE hello_snowflake_package
  ADD VERSION v1_1
  USING '@hello_snowflake_code.core.hello_snowflake_stage';

+---------------------------------------------------------------------------------------+---------+-------+
| status                                                                                | version | patch |
|---------------------------------------------------------------------------------------+---------+-------|
| Version 'v1_1' of application package 'hello_snowflake_package' created successfully. | v1_1    |     0 |
+---------------------------------------------------------------------------------------+---------+-------+