ALTER APPLICATION PACKAGE … VERSION¶

Syntaxe¶

ALTER APPLICATION PACKAGE <name> ADD VERSION [ <version_identifier> ]
  USING <path_to_version_directory> [ LABEL = '<display_label>' ]

ALTER APPLICATION PACKAGE <name> DROP VERSION <version_identifier>

ALTER APPLICATION PACKAGE <name> ADD PATCH FOR VERSION [<version_identifier>]
  USING <path_to_version_directory> [ LABEL = '<display_label>' ]

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.

ADD VERSION [ version_identifier ] USING path_to_version_directory

Ajoute une version ou un correctif en utilisant les fichiers d’application situés dans le chemin vers une zone de préparation spécifiée par path_to_version_directory.

Vous pouvez spécifier un identificateur pour cette version en utilisant version_identifier. Si vous ne spécifiez pas de version_identifier dans le fichier manifeste, vous devez spécifier un version_identifier dans le cadre de cette commande. Si vous spécifiez version_identifier dans le cadre de cette commande, il est prioritaire sur version_identifier spécifié dans le fichier manifeste.

[ LABEL = 'display_label' ]

Vous pouvez utiliser la clause LABEL pour spécifier une balise pour cette nouvelle version. Cette balise est affichée pour le consommateur. Si vous omettez la clause LABEL, c’est la balise spécifiée dans le fichier manifest.yml qui est utilisée.

DROP VERSION version_identifier

Supprime la version dont le nom est spécifié.

Supprime une version avec l’identificateur de version spécifié. Une version ne peut être supprimée que si aucune directive de version ne s’y réfère. La suppression est un processus asynchrone qui s’achève lorsque toutes les instances d’application ont bien été mises à niveau à partir de l’ancienne version et qu’il n’y a plus de code fonctionnant sur la version supprimée.

Utilisez la vue Vue APPLICATION_STATE pour surveiller le statut des instances d’application. Utilisez la commande SHOW VERSIONS pour surveiller le statut de la version supprimée.

ADD PATCH FOR VERSION version_identifier . USING path_to_version_directory [ LABEL = 'display_label' ]

Ajoute un correctif pour la version spécifiée (version_identifier) en utilisant les fichiers d’application situés dans le chemin spécifié vers une zone de préparation (path_to_version_directory).

Vous pouvez utiliser la clause LABEL pour spécifier une balise pour ce nouveau correctif. Cette balise est affichée pour le consommateur. Si vous omettez la clause LABEL, c’est la balise spécifiée dans le fichier manifest.yml qui est utilisée.

Notes sur l’utilisation¶

• Les identificateurs de version ont une limite maximale de 30 caractères.

• Une seule version peut comporter jusqu’à 130 correctifs.

• La modification de la version nécessite un rôle doté du privilège OWNERSHIP sur l’application ou du privilège global MANAGE VERSIONS.

• 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.

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 |
+---------------------------------------------------------------------------------------+---------+-------+