Mise à niveau sur place de la version majeure d'Amazon DocumentDB

Type d'instance — Amazon DocumentDB 4.0+ ne prend pas en charge les instances db.r4. Modifiez toutes les instances en db.r4.* db.r5.* instances ou en versions plus récentes avant de procéder à la mise à niveau. Consultez Modification d'une instance Amazon DocumentDB et Classes d'instances prises en charge par région.

Correctifs du système d'exploitation : appliquez toutes les actions de maintenance du système d'exploitation en attente sur toutes les instances avant la mise à niveau. Consultez Mises à jour du système d'exploitation Amazon DocumentDB.

Limites d'index sur les instances burstables (instances de la famille t) : si vous avez plus de 3 000 index sur les instances burstables, augmentez l'index principal à au moins db.r5.large avant de procéder à la mise à niveau. Vous pouvez réduire la taille une fois la mise à niveau terminée.

Groupe de paramètres — Nous vous recommandons de disposer d'un groupe de paramètres de cluster personnalisé pour la version cible avant la mise à niveau. Si aucun n'est spécifié, le groupe de paramètres par défaut de la version cible sera utilisé (par exemple, default.docdb5.0 oudefault.docdb8.0).

Instantané manuel : créez un instantané manuel avant la mise à niveau. Le processus de mise à niveau crée un instantané automatique nommépreupgrade-<name>-<version>-<timestamp>, mais nous vous recommandons vivement de disposer de votre propre sauvegarde. Consultez Création d'un instantané de cluster manuel.

Collation. Amazon DocumentDB 8.0 prend en charge le classement. Après la mise à niveau, le classement est activé par défaut pour les nouvelles collections et leurs index, ainsi que pour les nouveaux index des collections existantes.

Index du texte. Les nouveaux index de texte sont créés à l'aide de Text Index V2, qui utilise un analyseur de recherche de texte mis à jour pour améliorer la compatibilité avec MongoDB. Les index de texte existants ne sont pas affectés.

Version du planificateur de requêtes. Si vous n'avez pas de groupe de paramètres personnalisé, un nouveau groupe de paramètres par défaut est créé pour Amazon DocumentDB 8.0 avec Planner Version 3 automatiquement sélectionnée. Avec la version 3 du planificateur de requêtes, les vues sont également disponibles.

Compression. Amazon DocumentDB 8.0 prend en charge la compression de documents basée sur un dictionnaire à l'aide de l'algorithme Zstd. Après la mise à niveau, de nouvelles collections sont créées avec la compression Zstd activée par défaut. Les collections existantes à partir de la version 5.0 conservent leurs paramètres de compression. Pour tirer parti de la compression Zstd sur les collections existantes, vous pouvez modifier leurs paramètres de compression. Pour plus d'informations, consultez la section Dictionary-based compression.

Reconstruction de l'index. Si vous effectuez une mise à niveau d'Amazon DocumentDB 5.0 vers Amazon DocumentDB 8.0, aucune reconstruction d'index n'est nécessaire.

Reconstruction de l'index. Un MVU conserve les index d'origine. Amazon DocumentDB 5.0 a amélioré la maintenance des index et la collecte des déchets, en particulier pour les index à faible cardinalité. Après la mise à niveau depuis la version 3.6 ou 4.0, nous vous recommandons de reconstruire vos index afin de garantir des performances de requête optimales (facultatif, implique des éléments supplémentaires I/O). Consultez Maintenance de l'index en utilisant reIndex.

Comparaison numérique des sous-documents (3.6 uniquement). Les clusters mis à niveau à partir de la version 3.6 héritent du comportement de la version 3.6 selon lequel les types numériques des sous-documents ne sont pas comparés entre les types. Par exemple, ce {a: {b: NumberLong(1)}} n'est pas égal {a: {b: 1}} dans la version 3.6, mais ils sont égaux dans la version 4.0 et les versions ultérieures. Ce comportement affecte tous les clusters mis à niveau depuis la version 3.6.

Échec de la mise à niveau et annulation. Si la mise à niveau échoue, elle tente automatiquement de revenir en arrière. Une restauration réussie génère l'événement suivant : « Le cluster de base de données est dans un état qui ne peut pas être mis à niveau ». Votre cluster revient à son état antérieur à la mise à niveau et vous pouvez continuer à l'utiliser. Contactez l' AWS assistance pour résoudre le problème avant de réessayer.

Post-upgrade performance. Une dégradation temporaire des performances et une utilisation élevée du processeur peuvent se produire pendant l'actualisation des métadonnées de l'index. Si la dégradation persiste au-delà de 3 heures, contactez AWS le support.