Partager via

Mettre à niveau un cluster dans Azure Cosmos DB for PostgreSQL

  • Article

S’APPLIQUE À : Azure Cosmos DB for PostgreSQL (avec l’extension de base de données Citus pour PostgreSQL)

Ces instructions décrivent la procédure de mise à niveau vers une nouvelle version principale de PostgreSQL sur tous les nœuds de cluster.

Tester en premier lieu la mise à niveau

La mise à niveau de PostgreSQL entraîne plus de modifications que vous ne pouvez l’imaginer, car Azure Cosmos DB for PostgreSQL met également à niveau les extensions de base de données, notamment l’extension Citus. Les mises à niveau nécessitent aussi un temps d’arrêt dans le cluster de base de données.

Nous vous recommandons vivement de tester votre application avec les nouvelles versions de PostgreSQL et de Citus avant de mettre à niveau votre environnement de production. Consultez également notre liste de précautions à prendre pour la mise à niveau.

Un moyen pratique de la tester consiste à effectuer une copie de votre cluster à l’aide d’une restauration à un instant dans le passé. Mettez à niveau la copie et testez votre application sur celle-ci. Une fois que vous avez vérifié que tout fonctionne correctement, mettez à niveau le cluster d’origine.

Mettre à niveau un cluster dans le portail Azure

  1. Dans la section Présentation d’un cluster, sélectionnez le bouton Mettre à jour.
  2. Un dialogue s’affiche, indiquant la version actuelle de PostgreSQL et de Citus. Choisissez une nouvelle version de PostgreSQL dans la liste de versions PostgreSQL à mettre à niveau.
  3. Vérifiez que la valeur de la version Citus après la mise à niveau est celle que vous attendez. Cette valeur change en fonction de la version de PostgreSQL que vous avez sélectionnée.
  4. Sélectionnez le bouton Mettre à niveau pour continuer.

Notes

Si vous exécutez déjà la dernière version de PostgreSQL, la sélection et le bouton sont grisés.

Tâches postérieures à la mise à niveau

Après une mise à niveau majeure de la version de PostgreSQL, exécutez l’opération ANALYZE pour actualiser la table pg_statistic. pg_statistic est une table de catalogue système dans PostgreSQL qui stocke les données statistiques sur le contenu des colonnes de table et des expressions d’index. Les entrées de pg_statistic sont créées par la commande ANALYZE et utilisées par le planificateur de requêtes.

Exécutez la commande ANALYZE sans aucun paramètre pour générer des statistiques pour les tables de la base de données sur votre cluster. Le nom de la base de données par défaut est « citus ». Si un nom de base de données personnalisé a été utilisé lors de la création du cluster, vous pouvez le trouver sur la page Vue d’ensemble des propriétés de votre cluster. Vous pouvez voir la progression en utilisant l’indicateur VERBOSE (facultatif).

ANALYZE VERBOSE;

Remarque

Si vous n’exécutez pas l’opération ANALYZE après la mise à jour majeure de la version de PostgreSQL sur votre cluster, les performances de la base de données risquent d’être affectées.

Étapes suivantes