Mettre à jour et mettre à niveau une Snowflake Native App¶

Différences entre les versions et les correctifs¶

Lorsqu’un fournisseur publie une nouvelle version d’une application, le Snowflake Native App Framework s’assure que seule la version précédente de l’application est active. Par exemple, si un fournisseur a publié les versions V1 et V2 d’une application, le Snowflake Native App Framework s’assure que seule la version V2 est actuellement installée sur le compte d’un consommateur avant de passer à la version V3. Ainsi, le script d’installation ne doit tenir compte que des différences entre les versions V2 et V3. En d’autres termes, le script d’installation n’est rétrocompatible qu’avec la version la plus récente de l’application. Si un fournisseur modifie l’état de l’application, par exemple, en créant une nouvelle table ou en ajoutant des colonnes à une table, il n’existe pas de problème de compatibilité entre les versions.

En revanche, lorsqu’un fournisseur publie un nouveau correctif pour une version d’une application, le Snowflake Native App Framework n’impose aucune restriction quant au nombre de correctifs actifs en cours d’exécution. Les fournisseurs doivent éviter de modifier l’état d’une application dans un correctif.

À propos des mises à niveau dans différentes régions¶

Voir Mettre à niveau une application installée dans plusieurs régions pour des informations sur la mise à niveau d’une application installée dans différentes régions.

Privilèges nécessaires pour ajouter ou supprimer des versions et des correctifs¶

Pour spécifier une version ou un correctif pour un paquet d’application, vous devez disposer de l’un des privilèges suivants accordés à votre rôle sur le paquet d’application :

• OWNERSHIP

• MANAGE VERSIONS

Par exemple, pour accorder le privilège MANAGE VERSION sur le paquet d’application au rôle release_mgr, utilisez la commande GRANT <privilèges> comme indiqué dans l’exemple suivant :

GRANT MANAGE VERSIONS ON APPLICATION PACKAGE hello_snowflake_package
  TO ROLE release_mgr;

Ajouter une version à un paquet d’application via SQL¶

L’exemple suivant montre comment utiliser la commande ALTER APPLICATION PACKAGE pour ajouter une version à un paquet d’application.

ALTER APPLICATION PACKAGE MyAppPackage
  ADD VERSION v1_0
  USING '@dev_stage/v1_0'
  LABEL = 'MyApp Version 1.0';

Dans cet exemple, v1_0 est un identificateur de la version qui n’est pas visible par les consommateurs lorsqu’ils installent l’application. Le consommateur voit les informations relatives à la version, telles que définies dans la clause LABEL.

Seules deux versions d’une application peuvent exister en même temps. Par exemple, si vous définissez v1_0 et v1_1 dans une application, vous devez supprimer v1_0 pour créer v1_2. Cependant, vous pouvez avoir plusieurs correctifs pour une seule version.

Vous pouvez définir le nom de la version et la balise dans le fichier manifest.yml ou les spécifier directement avec la commande ALTER APPLICATION PACKAGE. Si vous les définissez dans le fichier manifest.yml ainsi qu’avec la commande SQL, les valeurs spécifiées dans la commande SQL ont la priorité sur les valeurs spécifiées dans le fichier manifest.yml.

Ajouter un correctif à un paquet d’application via SQL¶

En plus de créer des versions pour une application, vous pouvez également créer des correctifs pour une version spécifique. Comme les versions, les correctifs d’application ont également leurs propres fichiers d’application.

Pour créer un nouveau correctif pour un paquet d’application, utilisez la clause ADD PATCH FOR VERSION de la commande ALTER APPLICATION PACKAGE … VERSION , comme indiqué dans l’exemple suivant :

ALTER APPLICATION PACKAGE MyAppPackage
 ADD PATCH FOR VERSION V1_0
 USING '@dev_stage/v1_0_p1;

Dans l’exemple, aucun numéro de correctif n’est fourni à la clause ADD PATCH FOR VERSION V1_0. Dans ce cas, Snowflake incrémente automatiquement le numéro de correctif de 1.

Pour créer un nouveau correctif pour un paquet d’application avec un numéro de correctif personnalisé, fournissez un numéro de correctif à la clause ADD PATCH FOR VERSION de la commande ALTER APPLICATION PACKAGE … VERSION, comme indiqué dans l’exemple suivant :

ALTER APPLICATION PACKAGE MyAppPackage
 ADD PATCH 3
 FOR VERSION V1_0
 USING '@dev_stage/v1_0_p1;

Afficher les versions et les correctifs d’un paquet d’application¶

En tant que fournisseur, vous pouvez voir les versions et les correctifs définis pour une application en exécutant la commande SHOW VERSIONS sur le paquet d’application.

La commande suivante affiche les versions et les correctifs qui ont été définis pour un paquet d’application nommé hello_snowflake_package :

SHOW VERSIONS IN APPLICATION PACKAGE hello_snowflake_package;

Supprimer une version d’un paquet d’application¶

Pour supprimer une version d’un paquet d’application, vous devez vérifier qu’il n’existe pas de directives de version pointant actuellement vers la version à supprimer.

Pour afficher les directives de version spécifiées dans un paquet d’application, exécutez la commande SHOW RELEASE DIRECTIVES comme indiqué dans l’exemple suivant :

SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE hello_snowflake_package;

Pour supprimer une version d’un paquet d’application, utilisez la clause DROP VERSION de la commande ALTER APPLICATION PACKAGE comme indiqué dans l’exemple suivant :

ALTER APPLICATION PACKAGE hello_snowflake_package
  DROP VERSION v1_0;

Après l’exécution de cette commande, la version n’est pas supprimée tant que toutes les instances installées de l’application n’ont pas été supprimées. Pour vérifier le statut de la commande de suppression, utilisez la commande SHOW VERSIONS comme indiqué dans l’exemple suivant :

SHOW VERSIONS IN APPLICATION PACKAGE hello_snowflake_package;

La colonne dropped_on indique l’horodatage du lancement de la suppression.

Lorsqu’une version est supprimée, les consommateurs ne peuvent plus installer de nouvelles instances de cette version de l’application.

Selon la manière dont l’application est publiée auprès des consommateurs, la suppression de la version peut prendre plus ou moins de temps :

• Si le paquet d’application n’a pas été publié auprès des consommateurs, la version est immédiatement supprimée.

• Si le paquet d’application a été publié sous forme d’annonce publique ou privée dans une seule région, la version est immédiatement supprimée.

• Si le paquet d’application est publié sous forme de produit de données d’une annonce partagée dans la même région que celle du paquet d’application, la version est supprimée en l’espace de quelques heures.

• Si le paquet d’application est publié sous forme de produit de données d’une annonce via Exécution automatique inter-Cloud, il faudra peut-être plus de temps pour que la version soit supprimée dans toutes les régions.

Privilèges nécessaires pour définir la directive de version¶

Pour définir une directive de version, un fournisseur doit avoir le privilège MANAGE RELEASES ou être propriétaire du paquet d’application.

GRANT MANAGE RELEASES ON APPLICATION PACKAGE hello_snowflake_package
  TO ROLE release_mgr;

Définir la directive de version par défaut d’un paquet d’application¶

Utilisez la commande ALTER APPLICATION PACKAGE avec SET DEFAULT RELEASE DIRECTIVE pour définir la directive de version par défaut, comme indiqué dans l’exemple suivant :

ALTER APPLICATION PACKAGE hello_snowflake_package
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = v1_0
  PATCH = 2;

Pour mettre à jour la directive de version par défaut d’un paquet d’application, exécutez de nouveau la commande ALTER APPLICATION PACKAGE avec SET DEFAULT RELEASE DIRECTIVE, en spécifiant de nouvelles valeurs pour VERSION ou PATCH, le cas échéant.

Définir une directive de version personnalisée d’un paquet d’application¶

Pour ajouter une directive de version personnalisée, utilisez la commande ALTER APPLICATION PACKAGE avec SET RELEASE DIRECTIVE. Utilisez la clause ACCOUNTS pour spécifier les comptes auxquels s’applique cette directive de version. Par exemple :

ALTER APPLICATION PACKAGE hello_snowflake_package
  SET RELEASE DIRECTIVE hello_snowflake_package_custom
  ACCOUNTS = (CONSUMER_ORG.CONSUMER_ACCOUNT)
  VERSION = v1_0
  PATCH = 0;

Mettre à jour une directive de version personnalisée¶

Pour mettre à jour la version ou le correctif d’une directive de version personnalisée, utilisez la commande ALTER APPLICATION PACKAGE avec MODIFY RELEASE DIRECTIVE comme indiqué dans l’exemple suivant :

ALTER APPLICATION PACKAGE hello_snowflake_package
  MODIFY RELEASE DIRECTIVE hello_snowflake_package_custom
  VERSION = v1_0
  PATCH = 0;

En revanche, vous ne pouvez pas modifier les comptes associés à la directive de version. Pour modifier l’organisation et le compte associés à une directive de version, procédez comme suit :

1. Supprimez la directive de version du paquet d’application en exécutant la commande ALTER APPLICATION PACKAGE avec UNSET RELEASE DIRECTIVE.

2. Ajoutez à nouveau la directive de version au paquet d’application en exécutant la commande ALTER APPLICATION PACKAGE avec SET RELEASE DIRECTIVE et en utilisant la clause ACCOUNTS pour spécifier la liste des comptes.

Supprimer une directive de version personnalisée¶

Pour supprimer une directive de version personnalisée d’un paquet d’application, utilisez la commande ALTER APPLICATION PACKAGE avec UNSET RELEASE DIRECTIVE comme indiqué dans l’exemple suivant :

ALTER APPLICATION PACKAGE hello_snowflake_package
  UNSET RELEASE DIRECTIVE hello_snowflake_package_custom;

Tester une version et un correctif à l’aide d’une directive de version¶

Lors de l’installation d’une application à partir d’un paquet d’application en mode développement, la version et le correctif sont explicitement spécifiés. Cependant, lorsque l’application est installée à l’aide de la commande suivante :

CREATE APPLICATION hello_snowflake
  FROM APPLICATION PACKAGE hello_snowflake_package

La directive de version détermine la version qui est installée lors de l’exécution de cette commande.

Workflow de mise à niveau d’une Snowflake Native App¶

Un fournisseur met à niveau une application installée via le workflow suivant :

1. Mettez à jour la logique d’application et le script d’installation du paquet d’application.

2. Si deux versions sont actuellement définies, supprimez une version du paquet d’application.

3. Créer une nouvelle version ou un nouveau correctif pour les modifications apportées au paquet d’application.

   Si la propriété DISTRIBUTION de l’application est définie sur EXTERNAL, l”analyse de sécurité automatisée est lancée. L’analyse de sécurité doit s’effectuer correctement avant que la mise à niveau puisse avoir lieu.

4. Testez la nouvelle version en créant un objet APPLICATION dans le compte test du fournisseur.

5. Mettez à jour la directive de version pour la version ou le correctif.

   Cette opération lance une mise à niveau automatisée qui mettra à jour toutes les instances installées de la version précédente. Un fournisseur peut informer le consommateur qu’une mise à niveau est disponible et lui demander d’effectuer manuellement une mise à niveau manuelle.

Mettre à niveau une application installée dans plusieurs régions¶

Si un fournisseur publie une Snowflake Native App via Exécution automatique inter-Cloud, les mises à niveau automatisées peuvent prendre un certain temps en fonction des facteurs suivants :

• La valeur de la planification d’actualisation.

• Le nombre d’instances installées de l’application.

• Le nombre de régions dans lesquelles l’application est déployée.

Si la mise à niveau contient un correctif urgent qui doit être mis à niveau dans une région distante, les fournisseurs peuvent envisager les moyens suivants pour effectuer une mise à niveau plus rapidement :

• Réduire la fréquence d’actualisation de l’annonce à une valeur inférieure.

  Note

  La réduction de la fréquence d’actualisation peut augmenter les coûts associés à la réplication. Pour plus d’informations, voir Configuration de l’exécution automatique inter-Cloud.

• Demander au consommateur d”effectuer une mise à niveau manuelle.

Effectuer une mise à niveau manuelle d’une application installée¶

Les mises à niveau manuelles permettent à un consommateur de lancer la mise à niveau d’une version ou d’un correctif installé(e) d’une application via la directive de version spécifiée dans le paquet d’application.

Pour mettre à niveau une Snowflake Native App installée à la dernière version disponible, un consommateur peut utiliser la clause UPGRADE de la commande ALTER APPLICATION pour modifier l’objet de l’application :

ALTER APPLICATION <name> UPGRADE

Afficher le statut d’une mise à niveau¶

Pour afficher l’état de mise à niveau d’une application, utilisez la vue système Vue APPLICATION_STATE comme indiqué dans l’exemple suivant :

SELECT * FROM snowflake.data_sharing_usage.APPLICATION_STATE

Cette vue comprend des colonnes spécifiques aux mises à niveau, notamment l’état de mise à niveau et la région dans laquelle l’application est déployée.