ALTER APPLICATION PACKAGE¶
Ändert die Eigenschaften eines bestehenden Anwendungspakets im Native Apps Framework.
- Siehe auch:
CREATE APPLICATION PACKAGE, DROP APPLICATION PACKAGE, SHOW APPLICATION PACKAGES, SHOW VERSIONS, SHOW RELEASE DIRECTIVES
Syntax¶
ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> SET
[ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
[ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
[ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
[ COMMENT = <string-literal> ]
[ DISTRIBUTION = { INTERNAL | EXTERNAL } ]
[ MULTIPLE_INSTANCES = TRUE ]
ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> UNSET
[ DATA_RETENTION_TIME_IN_DAYS ]
[ MAX_DATA_EXTENSION_TIME_IN_DAYS ]
[ DEFAULT_DDL_COLLATION ]
[ COMMENT ]
[ DISTRIBUTION ]
ALTER APPLICATION <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
ALTER APPLICATION <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
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.
SET ...
Gibt eine (oder mehrere) Eigenschaften an, die für das Anwendungspaket festgelegt werden sollen (getrennt durch Leerzeichen, Kommas oder Neue-Zeile-Zeichen):
DATA_RETENTION_TIME_IN_DAYS = num
Gibt die Anzahl der Tage an, für die Time Travel-Aktionen (CLONE und UNDROP) auf der Datenbank durchgeführt werden können, sowie die standardmäßige Time Travel-Aufbewahrungsdauer für alle in der Datenbank erstellten Schemas.
Der Wert, den Sie angeben können, hängt von der verwendeten Snowflake-Edition ab:
Standardausführung:
0
oder1
Enterprise Edition (oder höher):
0
bis90
MAX_DATA_EXTENSION_TIME_IN_DAYS = integer
Objektparameter, der die maximale Anzahl von Tagen angibt, für die Snowflake die Datenaufbewahrungsfrist für Tabellen in der Datenbank verlängern kann, um zu verhindern, dass Streams auf den Tabellen veraltet sind.
Eine detaillierte Beschreibung dieses Parameters finden Sie unter MAX_DATA_EXTENSION_TIME_IN_DAYS.
DEFAULT_DDL_COLLATION = 'collation_specification'
Gibt eine standardmäßige Sortierungsspezifikation für Folgendes an:
Alle neuen Spalten, die zu vorhandenen Tabellen in der Datenbank hinzugefügt wurden.
Alle Spalten in neuen Tabellen, die der Datenbank hinzugefügt wurden.
Durch das Festlegen des Parameters ändert sich nicht die Sortierungsspezifikation für vorhandene Spalten.
Weitere Informationen zu den Parametern finden Sie unter DEFAULT_DDL_COLLATION.
DEFAULT_DDL_COLLATION = 'collation_specification'
Gibt eine standardmäßige Sortierungsspezifikation für Folgendes an:
Alle neuen Spalten, die zu vorhandenen Tabellen in der Datenbank hinzugefügt wurden.
Alle Spalten in neuen Tabellen, die der Datenbank hinzugefügt wurden.
Durch das Festlegen des Parameters ändert sich nicht die Sortierungsspezifikation für vorhandene Spalten.
Weitere Informationen zu den Parametern finden Sie unter DEFAULT_DDL_COLLATION.
COMMENT = 'string_literal'
Fügt einen Kommentar hinzu oder überschreibt einen bestehenden Kommentar für die Datenbank.
DISTRIBUTION = { INTERNAL | EXTERNAL }
Gibt den Typ des Freigabeangebots an, das ein Anbieter erstellen kann, wenn er das Anwendungspaket als Datenprodukt eines Freigabeangebots verwendet.
INTERNAL
gibt an, dass ein Anbieter ein privates Freigabeangebot nur innerhalb derselben Organisation erstellen kann, in der das Anwendungspaket erstellt wurde. Der automatische Sicherheitsscan wird nicht durchgeführt, wenn die DISTRIBUTION-Eigenschaft auf INTERNAL eingestellt ist.EXTERNAL
gibt an, dass ein Anbieter Freigabeangebote außerhalb derselben Organisation erstellen kann, in der das Anwendungspaket erstellt wurde.
Unter Automatische Sicherheitsscans ausführen finden Sie Informationen zur Einstellung der DISTRIBUTION-Eigenschaft und zur automatischen Sicherheitsüberprüfung.
Bemerkung
Wenn Sie den Parameter
DISTRIBUTION
aufEXTERNAL
setzen, wird eine automatische Sicherheitsüberprüfung für jede im Anwendungspaket definierte aktive Version und jeden aktiven Patch ausgelöst.Die folgenden Einschränkungen gelten so lange, bis die automatische Sicherheitsüberprüfung den Status
APPROVED
hat:Sie können keine Freigaberichtlinie für eine Version oder einen Patch festlegen.
Sie können kein Freigabeangebot für das Anwendungspaket veröffentlichen.
MULTIPLE_INSTANCES = TRUE
Ermöglicht es dem Verbraucher, mehrere Instanzen einer Anwendung aus dem Anwendungspaket zu installieren. Diese Eigenschaft kann nicht für Anwendungspakete festgelegt werden, die in einer Testversion oder einem kostenpflichtigen Freigabeangebot enthalten sind.
Wenn mehrere Instanzen erlaubt sind, können Verbraucher maximal 10 Instanzen einer App in ihrem Konto installieren.
Vorsicht
Nachdem diese Eigenschaft auf „true“ eingestellt wurde, kann sie später nicht mehr auf
FALSE
eingestellt oder aufgehoben werden.
UNSET ...
Gibt eine (oder mehrere) Eigenschaft(en) und/oder Parameter an, die für das Anwendungspaket aufgehoben werden sollen, wodurch sie auf die Standardwerte zurückgesetzt werden:
DATA_RETENTION_TIME_IN_DAYS
MAX_DATA_EXTENSION_TIME_IN_DAYS
EXTERNAL_VOLUME
CATALOG
DEFAULT_DDL_COLLATION
TAG tag_name [ , tag_name ... ]
COMMENT
Sie können mehrere Eigenschaften/Parameter mit einer einzigen ALTER-Anweisung zurücksetzen; jedoch müssen einzelne Eigenschaften/Parameter durch ein Komma getrennt werden. Wenn Sie eine Eigenschaft und/oder einen Parameter zurücksetzen, geben Sie nur den Namen an. Die Angabe eines Wertes für die Eigenschaft gibt einen Fehler zurück.
Nutzungshinweise¶
Wenn Sie die Werte für die optionalen Eigenschaften nicht angeben, verwendet der Befehl die in der Manifestdatei der App angegebenen Werte.
Wenn Sie Werte für die Eigenschaften im Befehl und in der Manifestdatei der App 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.
Neue Versionen werden mit einer Standard-Patchnummer von 0 hinzugefügt.
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.
Beispiele¶
ALTER APPLICATION PACKAGE hello_snowflake_package SET
COMMENT = 'Altered the Hello Snowflake app.';
+-------------------------------------------+
| status |
|-------------------------------------------|
| Statement executed successfully. |
+-------------------------------------------+