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> ... ]
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 d’informations 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.
Concernant les métadonnées :
Attention
Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir 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';
+---------------------------------------------------------------------------------------+---------+-------+
| status | version | patch |
|---------------------------------------------------------------------------------------+---------+-------|
| Version 'v1_1' of application package 'hello_snowflake_package' created successfully. | v1_1 | 0 |
+---------------------------------------------------------------------------------------+---------+-------+