Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Mise à niveau sur place de la version majeure d'Amazon DocumentDB
Amazon DocumentDB ne rend les nouvelles versions des moteurs de base de données généralement disponibles qu'après des tests approfondis. Vous pouvez choisir comment et quand mettre à niveau vos clusters Amazon DocumentDB vers la nouvelle version.
Amazon DocumentDB prend actuellement en charge trois versions principales : Amazon DocumentDB 3.6, 4.0 et 5.0. Vous pouvez effectuer une mise à niveau de version majeure (MVU) sur place de votre base de données tout en conservant les mêmes points de terminaison, le même stockage et les mêmes balises que les clusters et pouvez continuer à utiliser vos applications sans aucune modification. Cette fonctionnalité est disponible gratuitement dans toutes les régions où Amazon DocumentDB 5.0 est disponible.
Important
Vos clusters Amazon DocumentDB ne seront pas disponibles lors de la mise à niveau de la version majeure sur place et vos clusters subiront plusieurs redémarrages. Les interruptions de mise à niveau peuvent varier d'un cluster à l'autre en fonction du nombre de collections, d'index, de bases de données et d'instances. Nous vous recommandons d'effectuer la mise à niveau pendant votre période de maintenance ou pendant les heures de faible utilisation. Une fois votre cluster mis à niveau, vous ne pouvez pas le rétrograder vers la version précédente, mais vous pouvez choisir de restaurer votre instantané de pré-mise à niveau sur un nouveau cluster.
Rubriques
Prérequis et limites du MVU
Voici les conditions préalables et les limites de la mise à niveau des versions majeures sur place que vous devrez peut-être comprendre et respecter avant d'effectuer la mise à niveau :
Type d'instance — Amazon DocumentDB 4.0/5.0 ne prend pas en charge les instances r4.*. Pour procéder à une mise à niveau de version majeure sur place, remplacez les instances r4.* par des instances r5.*. Pour plus d’informations, consultez Modification d'une instance Amazon DocumentDB. Consultez les instances prises en Classes d'instances prises en charge par région charge en fonction de la version du moteur Amazon DocumentDB.
Correctifs du système d'exploitation d'instance : une mise à niveau de version majeure sur place nécessite le dernier correctif du système d'exploitation (OS) pour pouvoir être effectuée. Appliquez toutes les actions de maintenance du système d'exploitation en attente sur les instances avant de procéder à la mise à niveau sur place. Pour de plus amples informations, veuillez consulter Mises à jour du système d'exploitation Amazon DocumentDB.
Note
Dans certains cas, si vous avez des correctifs de moteur au niveau du cluster en attente, les correctifs du système d'exploitation de l'instance ne sont pas visibles. Vous devrez peut-être appliquer des correctifs de moteur au niveau du cluster avant de procéder à l'application des correctifs du système d'exploitation de l'instance et, par la suite, à la mise à niveau de la version majeure sur place. Consultez Exécution d'une mise à jour du correctif de la version du moteur d'un cluster.
La mise à niveau des versions majeures sur place est disponible dans toutes les régions où Amazon DocumentDB 5.0 est disponible.
-
La mise à niveau des versions majeures sur place n'est pas prise en charge avec Amazon DocumentDB 4.0 comme version cible.
-
À partir d'Amazon DocumentDB 4.0, «. » dans les noms d'utilisateur n'est pas pris en charge. Si vous effectuez une mise à niveau d'Amazon DocumentDB 3.6 vers la version 5.0 et que votre nom d'utilisateur contient » . «, veuillez recréer votre nom d'utilisateur sans » . », avant de passer au MVU sur place.
La mise à niveau des versions majeures sur place n'est actuellement pas prise en charge sur les clusters globaux et les clusters élastiques Amazon DocumentDB.
Note
Pour mettre à niveau vos clusters globaux, supprimez vos clusters secondaires du cluster global, convertissez le cluster principal en cluster régional, effectuez une mise à niveau de version majeure sur place sur le cluster régional (principal), puis recréez le cluster global en ajoutant des clusters secondaires portant le même nom afin de conserver les mêmes points de terminaison que précédemment. Notez que des frais d'E/S seront facturés pendant que votre cluster principal mis à niveau réplique les données vers les clusters secondaires que vous venez d'ajouter. Pour obtenir des instructions détaillées sur la façon de supprimer des clusters secondaires d'un cluster global avant de les supprimer, consultezSupprimer un cluster d'un cluster global Amazon DocumentDB.
-
Si vous disposez d'un grand nombre d'index (> 3 000) fonctionnant dans des instances de performance éclatantes (par exemple, t3.medium ou t4g.medium), vous devez faire évoluer votre instance principale vers une instance plus grande (par exemple, au moins r5.large) pour effectuer la mise à niveau de la version majeure sur place. Vous pouvez choisir de réduire la taille de l'instance une fois que la mise à niveau de la version majeure sur place est terminée. Consultez le tableau ci-dessous pour connaître le nombre maximal d'index pris en charge sur les types d'instance db.t3 et db.t4g pour une mise à niveau de version majeure sur place :
Instance Nombre maximum d'index pris en charge pour le MVU sur place db.t4g.medium
3 KM
db.t3.medium
10 000
Bonnes pratiques pour les mises à niveau des versions majeures sur place
Rubriques
Testez sur place les mises à niveau des versions majeures à l'aide de clusters clonés
-
Pour tester les mises à niveau des versions majeures sur place, nous vous recommandons d'utiliser la fonction de clonage rapide pour créer un clone de votre cluster cible. Aucun coût de stockage n'est nécessaire pour tester la mise à niveau d'une version majeure sur place sur un volume cloné, sauf si vous modifiez les données du cluster. Pour plus d'informations sur le clonage de volume, consultezClonage d'un volume pour un cluster Amazon DocumentDB.
-
Pour obtenir une estimation plus réaliste du temps nécessaire pour terminer la mise à niveau de la version majeure sur place, faites correspondre le nombre d'instances du cluster cloné au cluster cible.
-
Nous vous recommandons de tester entièrement le cluster Amazon DocumentDB 5.0 récemment mis à niveau pour détecter toute différence fonctionnelle afin de vous assurer que tout fonctionne comme prévu.
Avant une mise à niveau de version majeure sur place
-
Préparez un groupe de paramètres de cluster compatible avec les versions.
Utilisez le groupe de paramètres de cluster par défaut d'Amazon DocumentDB pour la nouvelle version du moteur ou créez votre propre groupe de paramètres de cluster personnalisé pour la nouvelle version du moteur.
Si vous associez un groupe de paramètres de cluster Amazon DocumentDB dans le cadre de la demande de mise à niveau, la mise à niveau de la version majeure sur place redémarrera automatiquement le cluster pour appliquer le nouveau groupe de paramètres.
-
Assurez-vous que vous avez satisfait aux conditions requises pour une mise à niveau de version majeure sur place, comme indiqué dans la section Conditions préalables et limites.
-
Créez un instantané manuel.
Le processus de mise à niveau crée un instantané de votre cluster de base de données lors de la mise à niveau. Il est vivement recommandé de créer votre propre instantané manuel avant le processus de mise à niveau. Consultez Création d'un instantané de cluster manuel.
Note
L'instantané automatique créé par le processus de mise à niveau ne sera pas automatiquement supprimé une fois la mise à niveau de la version majeure sur place terminée. Cet instantané n'entraînera aucun frais tant qu'il est conservé pendant la période de conservation. Vous pouvez choisir de supprimer cet instantané une fois que vous avez vérifié la réussite de la mise à niveau de votre cluster.
L'instantané est nommé comme
preupgrade-<name>-<version>-<timestamp>.
-
Vérifiez si vous avez déjà planifié une mise à niveau de la version majeure sur place de votre cluster.
Si vous avez modifié le cluster et choisi de l'appliquer dans la fenêtre de maintenance suivante, le calendrier de mise à niveau des versions majeures sur place ne sera pas visible sur la console, mais vous pouvez le consulter dans la CLI. Vous pouvez exécuter la commande suivante pour vérifier si une mise à niveau de version majeure sur place est déjà planifiée :
aws docdb describe-db-cluster \ --region $REGION \ --db-cluster-identifier $CLUSTER_NAME "PendingModifiedValues": { "EngineVersion": "5.0.0" }, Effectuez plusieurs essais à l'aide d'un clone de volume dans des environnements inférieurs pour tester le cluster après la mise à niveau de la version majeure sur place, quel que soit le plan d'exécution et les différences fonctionnelles. Nous recommandons le clonage avec le même nombre et la même taille d'instances afin d'obtenir une meilleure estimation du temps d'exécution de la mise à niveau des versions majeures sur place. Pour de plus amples informations, veuillez consulter Clonage d'un volume pour un cluster Amazon DocumentDB.
Si l'étape précédente est réussie, procédez à la mise à niveau de la version majeure sur place sur le cluster de production.
Lors d'une mise à niveau de version majeure sur place
Vous pouvez suivre la progression de la mise à niveau de votre version majeure sur place en vous abonnant aux événements de maintenance du cluster. Une fois la mise à niveau terminée, vous recevrez l'événement « La version majeure du cluster de base de données a été mise à niveau ». Cet événement, ainsi que d'autres événements survenant pendant la mise à niveau, apparaissent dans la section « Événements et balises » de la page détaillée du cluster dans la console Amazon DocumentDB. Le statut du cluster passe ensuite de « mise à niveau » à « disponible ».
À partir de la CLI, vous pouvez exécuter aws docdb create-event-subscription pour créer des événements et aws docdb describe-events suivre les progrès. Vous pouvez également configurer des notifications d'événements pour les événements ci-dessus à Amazon SNS en tant que cible pour les notifications par e-mail, messages push et autres méthodes. Pour de plus amples informations, veuillez consulter Abonnement aux événements Amazon DocumentDB.
La mise à niveau de la version majeure sur place génère les événements suivants au cours de la mise à niveau :
<cluster-name><timestamp>Mise à niveau en cours : création d'un instantané préalable à la mise à niveau [preupgrade- -]
Mise à niveau en cours : volume de clonage.
Mise à niveau en cours : mise à niveau de Writer.
Mise à niveau en cours : mise à niveau des lecteurs.
La version majeure du cluster de base de données a été mise à niveau.
Les événements sont également visibles sur la console, sous la page Événements :
Dans le AWS CLI, vous pouvez utiliser les commandes suivantes pour suivre les progrès :
aws docdb describe-events --source-identifier $CLUSTER_NAME --source-type db-cluster { "Events": [ { "SourceIdentifier": "mycluster", "SourceType": "db-cluster", "Message": "Database cluster engine version upgrade started.", "EventCategories": [ "maintenance" ], "Date": "2023-07-11T23:20:32.444000+00:00", "SourceArn": "arn:aws:rds:us-east-1:xxxx:cluster:mycluster" } ] }
Après une mise à niveau de version majeure sur place
Pour Amazon DocumentDB 3.6, ajoutez une balise au cluster pour indiquer que le cluster a été mis à niveau vers Amazon DocumentDB 5.0 à partir d'Amazon DocumentDB 3.6 par opposition à un cluster Amazon DocumentDB 5.0 récemment créé. Reportez-vous à la section sur les différences entre un cluster Amazon DocumentDB 5.0 mis à niveau et un nouveau cluster Amazon DocumentDB 5.0.
Prenez un instantané manuel une fois le MVU en place terminé, au cas où vous auriez besoin de rétablir l'état après la mise à niveau. Le processus de capture automatique reprendra dès que la mise à niveau de la version majeure sur place sera terminée. L'instantané manuel n'entraînera aucun frais tant qu'il est conservé pendant la période de conservation.
Pour utiliser les nouvelles fonctionnalités associées à Amazon DocumentDB 5.0, par exemple le chiffrement au niveau des champs côté client, nous vous recommandons de mettre à niveau la version de votre pilote vers la version de l'API MongoDB 5.0. Pour plus d'informations, consultez Nouveautés d'Amazon DocumentDB 5.0 la liste des fonctionnalités d'Amazon DocumentDB 5.0.
Important
Immédiatement après avoir effectué la mise à niveau sur place de la version majeure (MVU), votre cluster Amazon DocumentDB 5.0 reremplit les métadonnées de l'index, sur la base desquelles le moteur de base de données optimise les plans d'exécution des requêtes. Les performances de requête attendues sur votre cluster Amazon DocumentDB reprendront une fois le processus de recalcul des métadonnées d'index terminé. Ce processus prend généralement quelques minutes, mais peut durer jusqu'à deux heures selon le nombre d'index de votre cluster. Un redémarrage immédiat, un basculement ou une augmentation ou une réduction de la taille de votre instance Writer après la mise en place d'un MVU peuvent perturber le processus de calcul des métadonnées d'index sur votre cluster. Une fois le MVU sur place terminé, nous vous recommandons d'apporter ces modifications une fois que vous aurez observé les performances de requête attendues sur votre cluster Amazon DocumentDB 5.0.
De plus, une fois le MVU sur place terminé, les données du flux de modifications disponibles seront limitées aux 3 dernières heures.
Veuillez contacter le AWS support si vous constatez que cette baisse de performance temporaire persiste pendant plus de deux heures après la mise en place du MVU.
Testez entièrement le cluster Amazon DocumentDB 5.0 mis à niveau pour vous assurer que tout fonctionne comme prévu.
Réalisation d'une mise à niveau de version majeure sur place
Différences entre les clusters mis à niveau Amazon DocumentDB 3.6/4.0 à 5.0 et les nouveaux clusters Amazon DocumentDB 5.0
-
Une mise à niveau de version majeure sur place conserve les index d'origine du cluster mis à niveau. Avec Amazon DocumentDB 5.0, nous avons amélioré l'efficacité globale de la maintenance des index et du processus de collecte des déchets, en particulier pour les index à faible cardinalité. En règle générale, nous vous recommandons de recréer vos index à l'aide de la commande reindex une fois le MVU terminé avec succès. La recréation d'index n'est pas obligatoire et implique des E/S supplémentaires. Pour plus d'informations, consultez. Maintenance de l'index Amazon DocumentDB à l'aide de reIndex
-
Comparaisons de sous-documents pour plusieurs types de données numériques :
-
Si le cluster est migré depuis Amazon DocumentDB 3.6, il héritera du comportement de comparaison des sous-documents Amazon DocumentDB 3.6. La différence fonctionnelle est limitée aux types numériques (tels que Long, Double, Decimal128) dans un sous-document. Par exemple,
{a: {b: {NumberLong(1)}}ce n'est pas égal{a: {b: 1}}dans Amazon DocumentDB 3.6, alors qu'ils sont comparés comme égaux dans Amazon DocumentDB 4.0 et versions ultérieures. -
Ce comportement de comparaison de sous-documents n'existe que dans Amazon DocumentDB 3.6 et dans les clusters Amazon DocumentDB 5.0 qui ont été mis à niveau à partir de la version 3.6 à l'aide d'une mise à niveau de version majeure sur place. Cela ne s'applique pas aux clusters Amazon DocumentDB 5.0 nouvellement créés.
-
Note
Pour obtenir la liste des différences fonctionnelles entre Amazon DocumentDB 3.6/4.0 et Amazon DocumentDB 5.0, consultez. Compatibilité d'Amazon DocumentDB avec MongoDB
Résolution des problèmes liés à une mise à niveau d'une version majeure sur place
En cas d'échec, la mise à niveau de la version majeure sur place tentera d'annuler la mise à niveau afin de rétablir le dernier état opérationnel du cluster avant le début de la mise à niveau. Une restauration réussie générera un événement : « Le cluster de base de données est dans un état qui ne peut pas être mis à niveau : le cluster DocumentDB est dans un état dans lequel la mise à niveau de la version majeure ne peut pas être effectuée correctement. » À ce stade, vous devez contacter l'équipe de AWS support pour résoudre les problèmes et réessayer la mise à niveau de la version. Vous pouvez continuer à utiliser votre charge de travail comme avant. Dans tous les autres rares scénarios où la mise à niveau prend plus de temps que prévu, veuillez contacter l'équipe d' AWS assistance pour obtenir de l'aide.
Une fois que votre MVU sur place est terminé avec succès, votre cluster mis à niveau peut subir une dégradation temporaire des performances et une utilisation élevée du processeur pendant une courte période, pendant que le processus d'actualisation des métadonnées d'index est en cours d'exécution. Si la dégradation des performances persiste pendant plus de 2 heures, contactez le AWS support.
