Mettre à niveau la version de l’API de votre compte Azure Cosmos DB pour le compte MongoDB

  • Article

S’APPLIQUE À : MongoDB

Cet article décrit comment mettre à niveau la version de l’API de votre compte API Azure Cosmos DB pour MongoDB. Après avoir effectué la mise à niveau, vous pourrez utiliser les fonctionnalités les plus récentes de l’API Azure Cosmos DB pour MongoDB. Le processus de mise à niveau n’interrompt pas la disponibilité de votre compte et ne consomme pas de RU/s, et ne réduit à aucun moment la capacité de la base de données. Les index ou données existants ne seront pas affectés par ce processus.

Lors de la mise à niveau vers une nouvelle version d’API, mettez à niveau les charges de travail de développement/test avant les charges de travail de production. Il est important de mettre à niveau vos clients vers une version compatible avec la version de l’API vers laquelle vous effectuez la mise à niveau avant de mettre à niveau votre compte Azure Cosmos DB pour MongoDB.

Notes

Actuellement, seuls les comptes éligibles utilisant la version serveur 3.2 peuvent être mis à niveau vers la version 3.6 et les versions supérieures. Si votre compte n’affiche pas l’option de mise à niveau, entrez un ticket de support.

Mise à niveau vers la version 4.2, 4.0 ou 3.6

Avantages de la mise à niveau vers la version 4.2 :

  • Plusieurs améliorations majeures apportées au pipeline d’agrégation, telles que la prise en charge de $merge, la trigonométrie, les expressions arithmétiques et bien plus encore.
  • Prise en charge du chiffrement des champs côté client qui sécurise davantage votre base de données en permettant à des champs individuels d’être chiffrés de manière sélective et en conservant la confidentialité des données chiffrées à partir des utilisateurs de base de données et des fournisseurs d’hébergement.

Avantages de la mise à niveau vers la version 4.0

Voici les nouvelles fonctionnalités de la version 4.0 :

  • Prise en charge des transactions multidocuments dans les collections non partitionnées.
  • Nouveaux opérateurs d’agrégation
  • Performances d’analyse améliorées
  • Stockage plus rapide et plus performant

Avantages de la mise à niveau vers la version 3.6

Voici les nouvelles fonctionnalités de la version 3.6 :

  • Amélioration de la stabilité et des performances
  • Prise en charge de nouvelles commandes de base de données
  • Prise en charge du pipeline d’agrégation par défaut et de nouvelles étapes d’agrégation
  • Prise en charge de la modification de flux
  • Prise en charge des index composés
  • Prise en charge inter-partitions pour les opérations suivantes : mise à jour, suppression, décompte et tri
  • Amélioration des performances pour les opérations d’agrégation suivantes : $count, $skip, $limit et $group
  • L’indexation de caractères génériques est maintenant prise en charge

Modifications par rapport à la version 3.2

  • Par défaut, la fonctionnalité Server Side Retry (SSR) est activée, ce qui évite à l’application cliente de retourner des erreurs 16500. Au lieu de cela, les requêtes reprennent jusqu’à ce qu’elles se terminent ou qu’elles expirent au terme du délai de 60 secondes.
  • Le délai d’expiration par requête est de 60 secondes.
  • Les collections MongoDB créées sur la nouvelle version du protocole auront uniquement la propriété _id indexée par défaut.

Action obligatoire lors de la mise à niveau de la version 3.2

Si vous effectuez une mise à niveau à partir de la version 3.2, le suffixe du point de terminaison du compte de base de données sera mis à jour au format suivant :

<your_database_account_name>.mongo.cosmos.azure.com

Si vous effectuez une mise à niveau à partir de la version 3.2, vous devrez remplacer le point de terminaison existant dans vos applications et pilotes qui se connectent à ce compte de base de données. Seules les connexions qui utilisent le nouveau point de terminaison auront accès aux fonctionnalités fournies dans la nouvelle version de l’API. Le point de terminaison de la version 3.2 précédente doit avoir le suffixe .documents.azure.com.

Lors de la mise à niveau de 3.2 vers des versions plus récentes, les index composés sont désormais requis pour effectuer des opérations de tri sur plusieurs champs afin de garantir des performances élevées et stables pour ces requêtes. Assurez-vous que ces index composés sont créés de façon à ce que vos tris multichamps soient exécutés correctement.

Notes

Le point de terminaison peut être légèrement différent si votre compte se trouve dans un cloud Azure souverain, gouvernemental ou limité.

Mise à niveau

  1. Connectez-vous au portail Azure.

  2. Accédez à votre compte Azure Cosmos DB for MongoDB. Ouvrez le volet Vue d’ensemble et vérifiez que votre version de serveur actuelle est 3.2 ou 3.6.

    Vérifiez la version actuelle de votre compte MongoDB à partir du portail Azure.

  3. Dans le menu de gauche, ouvrez le volet Features. Cela volet affiche les fonctionnalités de niveau compte disponibles pour votre compte de base de données.

  4. Sélectionnez la ligne Upgrade MongoDB server version. Si vous ne voyez pas cette option, votre compte peut ne pas être éligible pour cette mise à niveau. Créez un ticket de support si c’est le cas.

    Ouvrez le panneau Fonctionnalités et mettez à niveau votre compte.

  5. Passez en revue les informations relatives à la mise à niveau. Sélectionnez Set server version to 4.2 (ou 4.0 ou 3.6 en fonction de votre version actuelle).

    Examinez le guide de mise à niveau et sélectionnez Mettre à niveau.

  6. Après le démarrage de la mise à niveau, le menu Fonctionnalité est grisé et l’état est défini sur En attente. La mise à niveau prend environ 15 minutes : Ce processus n’affecte pas les fonctionnalités ou opérations existantes de votre compte de base de données. Une fois l’opération terminée, l’état Mettre à jour la version de serveur MongoDB indique la version mise à niveau. Veuillez contacter le support technique en cas de problème lors du traitement de votre demande.

  7. Voici quelques points à prendre en considération après la mise à niveau de votre compte :

    1. Si vous avez effectué une mise à niveau à partir de la version 3.2, revenez au panneau Vue d’ensemble et copiez la nouvelle chaîne de connexion à utiliser dans votre application. L’ancienne chaîne de connexion utilisée pour la version 3.2 continuera de fonctionner. Pour garantir une expérience cohérente, toutes vos applications doivent utiliser le nouveau point de terminaison.

    2. Si vous avez effectué une mise à niveau à partir de la version 3.6, votre chaîne de connexion existante sera mise à niveau vers la version spécifiée et devra continuer à être utilisée.

Passage à une version antérieure

Vous pouvez également faire passer votre compte à la version 4.0 ou la version 3.6 en suivant les mêmes étapes que celles décrites dans la section « Mise à niveau ».

Si vous avez effectué une mise à niveau à partir de la version 3.2 et que vous souhaitez revenir à cette version 3.2, il vous suffit de réutiliser votre chaîne de connexion (3.2) précédente avec l’hôte accountname.documents.azure.com qui reste la version active après la mise à niveau de la version 3.2.

Étapes suivantes