Politiques de maintenance contrôlées par le consommateur : Guide du fournisseur

Avec les politiques de maintenance contrôlées par les consommateurs, ceux-ci peuvent définir quand les mises à niveau des Snowflake Native App se produisent dans leurs comptes. Au lieu que les mises à niveau se produisent immédiatement lorsque vous publiez une nouvelle version, les consommateurs peuvent retarder les mises à niveau vers une fenêtre de maintenance adaptée à leurs opérations. Pour plus d’informations sur la manière dont les consommateurs créent et gèrent les politiques de maintenance, voir Politiques de maintenance contrôlées par le consommateur.

En tant que fournisseur, vous devez :

  • Activer les mises à niveau des fenêtres de maintenance sur vos directives de version.

  • Fixer une date limite de mise à niveau afin que les consommateurs ne puissent pas reporter les mises à niveau indéfiniment.

  • En option, aligner la maintenance du pool de calcul Snowpark Container Services avec la fenêtre de maintenance du consommateur. Un tel alignement est recommandé car il minimise les perturbations pour les consommateurs.

Activation des mises à niveau des fenêtres de maintenance

Lorsque vous définissez une directive de version, vous pouvez spécifier que les mises à niveau doivent respecter les politiques de maintenance des consommateurs en définissant le paramètre UPGRADE_IN_MAINTENANCE_WINDOW sur TRUE. Vous devez également définir le paramètre UPGRADE_DEADLINE, qui définit la dernière date et heure auxquelles la mise à niveau doit être effectuée. Après cette date limite, la mise à niveau est effectuée quelle que soit la politique de maintenance du consommateur.

Pour activer les mises à niveau des fenêtres de maintenance, utilisez la commande ALTER APPLICATION PACKAGE … MODIFY RELEASE CHANNEL comme indiqué dans l’exemple suivant :

ALTER APPLICATION PACKAGE my_app_package
  MODIFY RELEASE CHANNEL DEFAULT
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = v1_0
  PATCH = 2
  UPGRADE_IN_MAINTENANCE_WINDOW = TRUE
  UPGRADE_DEADLINE = '2026-2-10T10:00:00Z';

Cette commande configure la directive de version afin que les consommateurs ayant une politique de maintenance puissent retarder la mise à niveau jusqu’à leur prochaine fenêtre de maintenance, jusqu’au 10 février 2026 à 10 h 00 AM maximum.

Note

  • Le paramètre UPGRADE_DEADLINE est requis quandUPGRADE_IN_MAINTENANCE_WINDOW est défini sur TRUE. Fixez la date limite à une date et une heure laissant suffisamment de temps aux consommateurs pour effectuer la mise à niveau dans leurs fenêtres de maintenance.

  • Vous ne pouvez pas définir les paramètres UPGRADE_AFTER et UPGRADE_IN_MAINTENANCE_WINDOW en même temps. Si vous essayez de définir les deux, la commande échoue avec une erreur.

Activation de la maintenance automatique des pools de calcul

Si votre application utilise Snowpark Container Services, vous pouvez aligner les mises à niveau logicielles des nœuds du pool de calcul sur la fenêtre de maintenance du consommateur. Sans ce paramètre, les mises à niveau des applications et la maintenance des nœuds du pool de calcul sont des problèmes distincts qui peuvent survenir à différents moments. En activant la maintenance automatique des applications, les deux sont coordonnées dans la fenêtre de maintenance choisie par le consommateur.

Pour activer cette fonction, définissez la propriété AUTOMATIC_APPLICATION_MAINTENANCE sur le paquet d’application :

ALTER APPLICATION PACKAGE my_app_package
  SET AUTOMATIC_APPLICATION_MAINTENANCE = TRUE;

Lorsque cette option est activée, les mises à niveau logicielles du nœud de pool de calcul Snowpark Container Services sont planifiées pendant la période de maintenance du consommateur. L’application se met à jour en premier, puis la maintenance des nœuds du pool de calcul suit.

Que se passe-t-il lorsqu’un consommateur a une politique de maintenance ?

Lorsque vous publiez une mise à jour avec UPGRADE_IN_MAINTENANCE_WINDOW défini sur TRUE, ce qui suit se produit :

  • Si le consommateur a défini une politique de maintenance, la mise à niveau est retardée jusqu’à la prochaine fenêtre de maintenance définie par la politique du consommateur, ou jusqu’à la date limite de mise à niveau, la première échéance étant retenue.

  • Si le consommateur n’a pas défini de politique de maintenance, la mise à niveau a lieu pendant la fenêtre de maintenance par défaut du système.

  • Si AUTOMATIC_APPLICATION_MAINTENANCE est activé, le code de l’application est mis à niveau en premier, suivi de toute maintenance des nœuds du pool de calcul Snowpark Container Services, le tout dans la même fenêtre de maintenance.