ALTER APPLICATION PACKAGE¶

Modifie les propriétés d’un paquet d’application existant dans le Native Apps Framework.

Voir aussi :: CREATE APPLICATION PACKAGE, DROP APPLICATION PACKAGE, SHOW APPLICATION PACKAGES, SHOW VERSIONS, SHOW RELEASE DIRECTIVES

Syntaxe¶

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 } ]

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

Paramètres¶

name

Indique l’identificateur pour le paquet d’application à modifier. Si l’identificateur contient des espaces, des caractères spéciaux ou des caractères majuscules et minuscules, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.

SET

Spécifie une ou plusieurs propriétés à définir pour le paquet d’application (séparées par des espaces, des virgules ou de nouvelles lignes). Pour plus de détails sur les propriétés que vous pouvez définir, voir CREATE APPLICATION.

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

Spécifie le nom de la balise et la valeur de la chaîne de la balise.

La valeur de la balise est toujours une chaîne de caractères et le nombre maximum de caractères pour la valeur de la balise est 256.

Pour plus de détails sur la spécification des balises dans une instruction, voir Quotas de balises pour les objets et les colonnes.

UNSET

Spécifie une (ou plusieurs) propriété(s) et/ou paramètres de session à désactiver pour le paquet d’application, ce qui les réinitialise aux valeurs par défaut.

Pour plus de détails sur chaque propriété, reportez-vous à CREATE APPLICATION PACKAGE

TAG tag_name [ , tag_name ... ]: Supprime la balise spécifiée du paquet d’application.

Notes sur l’utilisation¶

Si vous ne spécifiez pas les valeurs des propriétés facultatives, la commande utilise les valeurs spécifiées dans le fichier manifeste de l’application.

Si vous spécifiez des valeurs pour les propriétés dans la commande et dans le fichier manifeste de l’application, les valeurs spécifiées dans la commande sont prioritaires.
Si deux versions sont actives (par exemple, si le déploiement de la version actuelle n’est pas terminé), l’ajout d’une nouvelle version entraîne une erreur.
Les nouvelles versions sont ajoutées avec un numéro de correctif par défaut de 0.
Regarding metadata:

Attention

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 Champs de métadonnées dans Snowflake.

Exemples¶

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

Copy

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