Mettre à niveau la version de l’API de votre compte Azure Cosmos DB pour le compte MongoDB
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
Connectez-vous au portail Azure.
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.
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.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.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).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.
Voici quelques points à prendre en considération après la mise à niveau de votre compte :
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.
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
- Découvrez les fonctionnalités de MongoDB version 4.2 prises en charge et non prises en charge.
- Découvrez les fonctionnalités de MongoDB version 4.0 prises en charge et non prises en charge.
- Découvrez les fonctionnalités prises en charge et non prises en charge de MongoDB version 3.6.
- Pour plus d’informations, consultez Fonctionnalités de Mongo version 3.6
- Vous tentez d’effectuer une planification de la capacité pour une migration vers Azure Cosmos DB ? Vous pouvez utiliser les informations sur votre cluster de bases de données existant pour la planification de la capacité.
- Si vous ne connaissez que le nombre de vCores et de serveurs présents dans votre cluster de bases de données existant, lisez Estimation des unités de requête à l’aide de vCores ou de processeurs virtuels
- Si vous connaissez les taux de requêtes typiques de votre charge de travail de base de données actuelle, lisez la section concernant l’estimation des unités de requête à l’aide du planificateur de capacité Azure Cosmos DB