ALTER APPLICATION¶

Syntax¶

ALTER APPLICATION [ IF EXISTS ] <name> SET
  [ COMMENT = '<string-literal>' ]
  [ SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE } ]
  [ DEBUG_MODE = { TRUE | FALSE } ]

ALTER APPLICATION [ IF EXISTS ] <name> UNSET
  [ COMMENT ]
  [ SHARE_EVENTS_WITH_PROVIDER ]
  [ DEBUG_MODE ]

 ALTER APPLICATION <name> UPGRADE

 ALTER APPLICATION <name> UPGRADE USING VERSION <version_name> [ PATCH <patch_num> ]

 ALTER APPLICATION <name> UPGRADE USING <path_to_stage>

 ALTER APPLICATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

 ALTER APPLICATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

 ALTER APPLICATION <name> UNSET REFERENCES[ ( '<reference_name>' [ , '<reference_alias>' ] ) ]

Parameter¶

name

Gibt den Bezeichner der Anwendung an, die geändert wird. 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.

SET

Gibt eine (oder mehrere) Eigenschaften an, die für die Anwendung 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.

COMMENT = '{string}'

Fügt einen Kommentar hinzu oder überschreibt einen vorhandenen Kommentar für die Anwendung.

:code:`DEBUG_MODE = { TRUE | FALSE | `

Aktiviert oder deaktiviert den Debug-Modus für die installierte Anwendung.

• TRUE aktiviert den Debug-Modus für die installierte Anwendung.

• FALSE deaktiviert den Debug-Modus für die installierte Anwendung.

Sie können DEBUG_MODE in der Anwendung nur einstellen, wenn die folgenden Bedingungen erfüllt sind:

• Die installierte Anwendung befindet sich in demselben Konto wie das Anwendungspaket.

• Die installierte Anwendung muss im Entwicklungsmodus erstellt worden sein.

  Der Entwicklungsmodus wird unter expliziter Angabe eines Stagingbereichs, einer Version oder eines Patches installiert.

• Sie haben die OWNERSHIP-Berechtigung für die installierte Anwendung, und Ihrer Rolle wird die DEVELOP-Berechtigung für das Anwendungspaket erteilt, mit dem die installierte Anwendung erstellt wurde.

SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE }

Gibt an, ob Protokolle und Ereignisdaten für den Anbieter freigegeben werden sollen.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Gibt den Namen des Tags und den Wert der Tag-Zeichenfolge an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann.

Weitere Informationen zur Angabe von Tags in einer Anweisung finden Sie unter Tag-Kontingente für Objekte und Spalten.

UPGRADE

Führt ein Upgrade der Anwendung aus, wenn der Anbieter der Anwendung angegeben hat, dass die Instanz aktualisiert werden soll.

Eine Anwendung wird automatisch aktualisiert, wenn der Anbieter angegeben hat, dass dies geschehen soll. Sie können diesen Befehl jedoch auch verwenden, um die das Upgrade sofort auszuführen, ohne auf das automatische Upgrade zu warten. Dieser Befehl kann nur für Anwendungen verwendet werden, die nicht im Entwicklungsmodus sind und die aus einem Freigabeangebot oder ohne Angabe eines Stagingbereichs oder einer Version installiert werden. Der Befehl ist in erster Linie dazu gedacht, den Upgrade-Prozess der Anwendung zu testen.

UPGRADE USING VERSION version_name [ PATCH patch_num ]

Führt ein Upgrade der Anwendung auf die angegebene Version durch. Wenn patch_num nicht angegeben ist, wird der neueste Patch verwendet. Dieser Befehl ist nur für Anwendungen gültig, die unter Angabe einer Version und eines Patches installiert wurden.

UPGRADE USING <path_to_version_directory>

Aktualisiert die Anwendung unter Verwendung von Dateien in einem benannten Stagingbereich unter dem in path_to_stage angegebenen Pfad.

Diese Klausel gilt nur, wenn Sie die Anwendung über einen benannten Stagingbereich installiert haben.

UNSET

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

Sie können mehrere Eigenschaften/Parameter mit einer einzigen ALTER-Anweisung zurücksetzen. Dabei müssen die einzelne Eigenschaften/Parameter aber durch ein Komma getrennt werden. Wenn Sie eine Eigenschaft oder einen Parameter zurücksetzen, geben Sie nur den Namen an. Die Angabe eines Wertes für die Eigenschaft oder den Parameter gibt einen Fehler zurück.

• COMMENT

• DEBUG_MODE deaktiviert den Debug-Modus für die installierte Anwendung. Diese Klausel ist semantisch dasselbe wie die Einstellung DEBUG_MODE = FALSE.

• TAG tag_name [ , tag_name ... ]

• REFERENCES[ ( 'reference_name' [, 'reference_alias' ] ) ]

  Hebt eine dauerhafte Referenz für eine Anwendung auf. Wenn keine Argumente übergeben werden, werden alle für die Anwendung festgelegten dauerhaften Verweise zurückgesetzt.

Nutzungshinweise¶

• Wenn Sie keine Werte für optionale Parameter angeben, werden die Werte für diese Parameter aus der Datei manifest.yml übernommen. Wenn Sie sowohl in der Manifest-Datei als auch bei Ausführung des Befehls Werte angeben, haben die im Befehl angegebenen Werte Vorrang.

• Regarding metadata:

  Achtung

  Customers should ensure that no personal data (other than for a User object), sensitive data, export-controlled data, or other regulated data is entered as metadata when using the Snowflake service. For more information, see Metadatenfelder in Snowflake.