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 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. Ce processus n'affecte pas les données ou les index existants.
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.
Avertissement
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.
Mettez à niveau votre version
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. Contactez 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 continue 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 est mise à niveau vers la version spécifiée et devra continuer à être utilisée.
Important
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. Le point de terminaison peut être légèrement différent si votre compte se trouve dans un cloud Azure souverain, gouvernemental ou limité.
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.
Rétrograder votre version
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 mettre à jour votre version.
Si vous avez effectué une mise à niveau à partir de la version 3.2 et que vous souhaitez revenir à cette version 3.2, réutilisez 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.Changer la chaîne de connexion dans votre application.