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> ... ]
Copy

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 oder 1

  • Enterprise Edition (oder höher): 0 bis 90

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 auf EXTERNAL 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.';
Copy
+-------------------------------------------+
| status                                    |
|-------------------------------------------|
| Statement executed successfully.          |
+-------------------------------------------+