ALTER APPLICATION

Ändert die Eigenschaften einer installierten Snowflake Native App. Verwenden Sie ALTER APPLICATION, um eine App auf eine bestimmte Version oder einen Patch zu aktualisieren. Mit diesem Befehl können Sie auch andere Eigenschaften für eine Anwendung einstellen.

Siehe auch:

CREATE APPLICATION, DESCRIBE APPLICATION, DROP APPLICATION, SHOW APPLICATIONS

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 [ IF EXISTS ] <name> RENAME TO <new_app_name>

ALTER APPLICATION <name> SET FEATURE POLICY <policy_name> [ FORCE ]

ALTER APPLICATION <name> UNSET FEATURE POLICY;

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> SET SHARED TELEMETRY EVENTS ('<event_definition' [ , <event_definition>, ...])

ALTER APPLICATION <name> SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }

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

ALTER APPLICATION <name> UPGRADE

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

ALTER APPLICATION <name> UPGRADE USING <path_to_stage>
Copy

Parameter

name

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

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.

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-Kontingent für Objekte.

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.

RENAME TO new_app_name

Gibt einen neuen Bezeichner für die Anwendung an. Dieser Bezeichner muss für Ihr Konto eindeutig sein.

SET FEATURE POLICY policy_name [ FORCE ]

Gibt die Feature-Richtlinie an, die auf die Anwendung angewendet werden soll. Wenn für die Anwendung bereits eine Feature-Richtlinie festgelegt ist, können Sie FORCE verwenden, um die Feature-Richtlinie festzulegen, ohne dass Sie die Feature-Richtlinie zuerst aufheben müssen.

UNSET FEATURE POLICY

Entfernt die Feature-Richtlinie aus der Anwendung. Wenn eine Feature-Richtlinie aus einer Anwendung entfernt wird, wird die Feature-Richtlinie auf Kontoebene angewendet, sofern sie existiert.

SET SHARED TELEMETRY EVENTS ( 'event_definition' [ , event_definition, ... ] )

Gibt die optionale Ereignisdefinition an, die für eine App aktiviert werden soll.

SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }

Wenn auf TRUE gesetzt, werden alle erforderlichen Ereignisdefinitionen für eine Anwendung aktiviert. Die optionalen Ereignisdefinitionen bleiben jedoch deaktiviert. Verwenden Sie die Klausel SET SHARED TELEMETRY EVENTS, um optionale Ereignisdefinitionen für eine Anwendung festzulegen.

Vorsicht

Nachdem Sie diesen Wert auf TRUE gesetzt haben, können Sie den Wert nicht mehr auf FALSE zurücksetzen, wenn es in der Anwendung erforderliche Ereignisdefinitionen gibt.

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

Entfernt die angegebenen Referenzen aus der Anwendung.

UPGRADE

Aktualisiert die Anwendung, wenn der Anbieter eine neue Version oder einen Patch für die Anwendung veröffentlicht hat.

Eine Anwendung wird automatisch aktualisiert, wenn der Anbieter die Release-Richtlinie der Anwendung festlegt. Sie können diesen Befehl jedoch auch verwenden, um das Upgrade sofort zu starten, ohne auf das automatische Upgrade zu warten. Dieser Befehl kann nur für Anwendungen verwendet werden, die nicht im Entwicklungsmodus erstellt wurden. Anwendungen im Entwicklungsmodus werden aus einem Freigabeangebot oder ohne Angabe eines Stagingbereichs oder einer Version installiert und sind in erster Linie zum Testen des Upgrade-Prozesses gedacht.

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_stage

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.

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.

  • Metadaten:

    Achtung

    Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „Benutzer“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.