View a markdown version of this page

Compatibilité d'Amazon DocumentDB avec MongoDB - Amazon DocumentDB

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.

Compatibilité d'Amazon DocumentDB avec MongoDB

Amazon DocumentDB est compatible avec MongoDB, notamment MongoDB 4.0, MongoDB 5.0 et MongoDB 8.0. La compatibilité avec MongoDB signifie qu'une grande majorité des applications, pilotes et outils que vous utilisez déjà aujourd'hui avec vos bases de données MongoDB peuvent être utilisés avec Amazon DocumentDB avec peu ou pas de modifications. Cette section décrit tout ce que vous devez savoir sur la compatibilité d'Amazon DocumentDB avec MongoDB, notamment les nouvelles fonctionnalités, la mise en route, les chemins de migration et les différences fonctionnelles.

Compatibilité avec MongoDB 8.0

Nouveautés d'Amazon DocumentDB 8.0

Amazon DocumentDB 8.0 multiplie par 7 les performances des requêtes et multiplie par 5 le taux de compression, ce qui vous permet de créer des applications hautes performances à moindre coût. Amazon DocumentDB 8.0 est entièrement compatible avec le protocole filaire MongoDB 8.0. Le résumé ci-dessous présente certaines des principales fonctionnalités introduites dans Amazon DocumentDB 8.0. Pour consulter la liste complète des nouvelles fonctionnalités, consultez le Notes de version.

  • Assure la compatibilité avec MongoDB 8.0 en ajoutant la prise en charge des pilotes d'API MongoDB 8.0. Supporte également les applications créées à l'aide des versions 6.0 et 7.0 de l'API MongoDB.

  • Le nouveau planificateur de requêtes d'Amazon DocumentDB 8.0 améliore les performances des opérateurs de la phase d'agrégation, tout en prenant en charge l'optimisation du pipeline d'agrégation et des commandes distinctes.

  • Amazon DocumentDB 8.0 prend en charge le classement et les affichages.

  • Propose 6 nouvelles étapes d'agrégation : $replaceWith, $vectorSearch, $merge, $set, $unset, $bucket et 3 nouveaux opérateurs d'agrégation $pow, $rand, $dateTrunc.

  • Une nouvelle version de l'index de texte : l'index de texte v2 d'Amazon DocumentDB 8.0 introduit des jetons supplémentaires, améliorant ainsi les fonctionnalités de recherche de texte.

  • Grâce à la création parallèle d'index vectoriels, Amazon DocumentDB 8.0 réduit le temps de création de l'index jusqu'à 30 fois.

  • Limite de stockage augmentée à 256 TiB.

Démarrez avec Amazon DocumentDB 8.0

Pour commencer à utiliser Amazon DocumentDB 8.0, consultez Démarrez avec Amazon DocumentDB. Vous pouvez créer un nouveau cluster Amazon DocumentDB 8.0 à l'aide du Console de gestion AWS ou le AWS KIT DE DÉVELOPPEMENT LOGICIEL, AWS CLI, ou CloudFormation. Lorsque vous vous connectez à Amazon DocumentDB, vous devez utiliser un pilote ou un utilitaire MongoDB compatible avec MongoDB 5.0 ou version ultérieure.

Note

Lors de l'utilisation du AWS KIT DE DÉVELOPPEMENT LOGICIEL, AWS CLI, ou CloudFormation, la version du moteur sera par défaut 5.0.0. Vous devez spécifier explicitement le paramètre engineVersion = 8.0.0 pour créer un nouveau cluster Amazon DocumentDB 8.0 ou engineVersion = 4.0.0 pour créer un nouveau cluster Amazon DocumentDB 4.0 ou engineVersion = 3.6.0 pour créer un nouveau cluster Amazon DocumentDB 3.6. Pour un cluster Amazon DocumentDB donné, vous pouvez déterminer la version du cluster à l'aide du AWS CLI pour appeler describe-db-clusters ou utilisez la console de gestion Amazon DocumentDB pour afficher le numéro de version du moteur pour un cluster spécifique.

Amazon DocumentDB 5.0 et 8.0 sont compatibles avec Amazon EC2 r8g Processeur Graviton4 et processeurs Graviton2 tels que r6g et t4.medium types d'instances pour vos clusters et est disponible dans toutes les instances prises en charge Régions AWS (voir instances). Pour plus d'informations sur les prix, voir Amazon DocumentDB (avec compatibilité avec MongoDB) Tarification.

Effectuez une mise à niveau ou migrez vers Amazon DocumentDB 5.0 ou 8.0

Vous pouvez migrer de MongoDB 3.6 ou MongoDB 4.0 vers Amazon DocumentDB 5.0 ou Amazon DocumentDB 8.0 à l'aide du AWS DMS ou des utilitaires tels que mongodump, mongorestore, mongoimport et mongoexport. Pour obtenir des instructions sur la migration, voir Mise à niveau de votre cluster Amazon DocumentDB à l'aide de AWS Database Migration Service.

Différences fonctionnelles

Différences fonctionnelles entre Amazon DocumentDB 5.0 et 8.0

Avec la sortie d'Amazon DocumentDB 8.0, il existe des différences fonctionnelles entre Amazon DocumentDB 5.0 et Amazon DocumentDB 8.0 :

  • Planner v1 est le planificateur de requêtes par défaut dans Amazon DocumentDB 5.0, tandis que le Planner v3, plus performant, est le planificateur par défaut dans Amazon DocumentDB 8.0.

  • Les nouvelles fonctionnalités d'Amazon DocumentDB 8.0, notamment les vues, le classement et les opérateurs tels que $merge, ne sont compatibles qu'avec Planner v3.

  • La compression est activée par défaut dans Amazon DocumentDB 8.0 et est configurée pour utiliser l'algorithme Zstandard. En outre, dans Amazon DocumentDB 8.0, enabled n'est plus une valeur valide pour default_collection_compression. Les valeurs valides sont zstd, lz4 et disabled.

  • Amazon DocumentDB 8.0 prend uniquement en charge le protocole TLS 1.2 et supérieur pour les connexions aux bases de données.

Important

Amazon DocumentDB 8.0 nécessite le protocole TLS 1.2 ou supérieur. Les protocoles TLS 1.0 et TLS 1.1 ne sont plus pris en charge.

Compatibilité avec MongoDB 5.0

Nouveautés d'Amazon DocumentDB 5.0

Amazon DocumentDB 5.0 introduit de nouvelles fonctionnalités et capacités, notamment les limites de stockage et le chiffrement au niveau des champs côté client. Le résumé ci-dessous présente certaines des principales fonctionnalités introduites dans Amazon DocumentDB 5.0. Pour consulter la liste complète des nouvelles fonctionnalités, consultez le Notes de version.

  • Augmentation de la limite de stockage à 128 TiB pour tous les clusters Amazon DocumentDB basés sur des instances et les clusters élastiques basés sur des partitions.

  • Présentation du moteur Amazon DocumentDB 5.0 (version 3.0.775)

    • Support pour les pilotes d'API MongoDB 5.0

    • Assistance pour Client-side Chiffrement au niveau du champ (FLE). Vous pouvez désormais chiffrer les champs côté client avant d'écrire les données dans le cluster Amazon DocumentDB. Pour plus d’informations, consultez Client-side chiffrement au niveau du champ.

    • Nouveaux opérateurs d'agrégation : $dateAdd, $dateSubtract

    • Supports pour les index avec $elemMatch opérateur. Par conséquent, les requêtes ayant $elemMatch entraînera des analyses d'index.

Amazon DocumentDB ne prend pas en charge toutes les fonctionnalités de MongoDB 5.0. Lorsque nous avons créé Amazon DocumentDB 5.0, nous avons travaillé en arrière à partir des fonctionnalités et des fonctionnalités que nos clients nous ont demandé de développer le plus souvent. Nous continuerons à ajouter des fonctionnalités supplémentaires à MongoDB 5.0 en fonction de ce que les clients nous demandent de développer. Pour obtenir la liste la plus récente des API prises en charge, consultez API, opérations et types de données MongoDB pris en charge dans Amazon DocumentDB.

Nouveautés d'Amazon DocumentDB 5.0.1

Amazon DocumentDB 5.0.1 est la première version mineure de la version majeure d'Amazon DocumentDB 5.0. Les versions mineures incluent des améliorations telles que de nouvelles fonctionnalités, des correctifs de sécurité et des corrections de bugs. Vous pouvez passer de la version 5.0.0 à la version 5.0.1 à l'aide d'une mise à niveau mineure. Pour plus d’informations, consultez Mise à niveau de la version mineure d'Amazon DocumentDB.

  • Capacités d'agrégation améliorées avec de nouveaux opérateurs ($rand, $pow, $dateToParts, $dateFromParts).

  • Mesure des connexions actives pour surveiller les instances. Pour plus d’informations, consultez Quotas d'instances.

  • Mesures de performance granulaires au niveau des commandes dans CloudWatch pour les opérations CRUD (find, insert, findAndModify, update, delete, aggregate, count, distinct, getMore, abortTransaction, commitTransaction), exposant AvgDuration, P100Duration, et MaxConcurrent dimensions pour une meilleure surveillance opérationnelle.

  • Amazon DocumentDB 5.0.1 prend uniquement en charge le protocole TLS 1.2 et supérieur pour les connexions aux bases de données.

  • Ajouté gcRuntimeStats, documentFragmentStats, et ventilation des indicateurs du niveau de collecte en storageSegmentBase et storageSegmentExtended dans collstats pour obtenir plus d'informations sur l'état général du processus de collecte des déchets.

Démarrez avec Amazon DocumentDB 5.0

Pour commencer à utiliser Amazon DocumentDB 5.0, consultez Démarrez avec Amazon DocumentDB. Vous pouvez créer un nouveau cluster Amazon DocumentDB 5.0 à l'aide du Console de gestion AWS ou le AWS KIT DE DÉVELOPPEMENT LOGICIEL, AWS CLI, ou CloudFormation. Lorsque vous vous connectez à Amazon DocumentDB, vous devez utiliser un pilote ou un utilitaire MongoDB compatible avec MongoDB 5.0 ou version ultérieure.

Note

Lors de l'utilisation du AWS KIT DE DÉVELOPPEMENT LOGICIEL, AWS CLI, ou CloudFormation, la version du moteur sera par défaut 5.0.0. Vous devez spécifier explicitement le paramètre engineVersion = 4.0.0 pour créer un nouveau cluster Amazon DocumentDB 4.0 ou engineVersion = 3.6.0 pour créer un nouveau cluster Amazon DocumentDB 3.6. Pour un cluster Amazon DocumentDB donné, vous pouvez déterminer la version du cluster à l'aide du AWS CLI pour appeler describe-db-clusters ou utilisez la console de gestion Amazon DocumentDB pour afficher le numéro de version du moteur pour un cluster spécifique.

Amazon DocumentDB 5.0 et 8.0 sont compatibles avec Amazon EC2 r8g Processeur Graviton4 et processeurs Graviton2 tels que r6g et t4.medium types d'instances pour vos clusters et est disponible dans toutes les instances prises en charge Régions AWS (voir instances). Pour plus d'informations sur les prix, voir Amazon DocumentDB (avec compatibilité avec MongoDB) Tarification.

Effectuez une mise à niveau ou migrez vers Amazon DocumentDB 5.0

Vous pouvez migrer de MongoDB 3.6 ou MongoDB 4.0 vers Amazon DocumentDB 5.0 à l'aide du AWS DMS ou des utilitaires tels que mongodump, mongorestore, mongoimport et mongoexport. Pour obtenir des instructions sur la migration, voir Mise à niveau de votre cluster Amazon DocumentDB à l'aide de AWS Database Migration Service.

Différences fonctionnelles

Différences fonctionnelles entre Amazon DocumentDB 4.0 et 5.0

Avec la sortie d'Amazon DocumentDB 5.0, il existe des différences fonctionnelles entre Amazon DocumentDB 4.0 et Amazon DocumentDB 5.0 :

  • Le rôle intégré de sauvegarde prend désormais en charge serverStatus. Action - Les développeurs et les applications dotés d'un rôle de sauvegarde peuvent collecter des statistiques sur l'état du cluster Amazon DocumentDB.

  • Le SecondaryDelaySecs le champ remplace slaveDelay dans replSetGetConfig sortie.

  • Le hello la commande remplace isMaster - hello renvoie un document qui décrit le rôle d'un cluster Amazon DocumentDB.

  • Amazon DocumentDB 5.0 prend désormais en charge les analyses d'index avec $elemMatch opérateur au premier niveau d'imbrication. Les analyses d'index sont prises en charge lorsque le filtre de requête uniquement possède un niveau de $elemMatch filtre mais ne sont pas pris en charge s'ils sont imbriqués $elemMatch la requête est incluse.

    Par exemple, dans Amazon DocumentDB 5.0, si vous incluez le $elemMatch opérateur au niveau imbriqué, il ne renverra pas de valeur comme dans Amazon DocumentDB 4.0 :

    db.foo.insert( [ {a: {b: 5}}, {a: {b: [5]}}, {a: {b: [3, 7]}}, {a: [{b: 5}]}, {a: [{b: 3}, {b: 7}]}, {a: [{b: [5]}]}, {a: [{b: [3, 7]}]}, {a: [[{b: 5}]]}, {a: [[{b: 3}, {b: 7}]]}, {a: [[{b: [5]}]]}, {a: [[{b: [3, 7]}]]} ]); // DocumentDB 5.0 > db.foo.find({a: {$elemMatch: {b: {$elemMatch: {$lt: 6, $gt: 4}}}}}, {_id: 0}) { "a" : [ { "b" : [ 5 ] } ] } // DocumentDB 4.0 > db.foo.find({a: {$elemMatch: {b: {$elemMatch: {$lt: 6, $gt: 4}}}}}, {_id: 0}) { "a" : [ { "b" : [ 5 ] } ] } { "a" : [ [ { "b" : [ 5 ] } ] ] }
  • La projection « $ » dans Amazon DocumentDB 4.0 renvoie tous les documents avec tous les champs. Avec Amazon DocumentDB 5.0, find Une commande avec une projection « $ » renvoie les documents correspondant au paramètre de requête contenant uniquement le champ correspondant à la projection « $ ».

  • Dans Amazon DocumentDB 5.0, find commandes avec $regex et $options les paramètres de requête renvoient une erreur : « Impossible de définir les options dans les deux cas $regex et $options«.

  • Avec Amazon DocumentDB 5.0, $indexOfCP renvoie désormais « -1 » lorsque :

    • la sous-chaîne est introuvable dans l'expression de chaîne, ou

    • le début est un nombre supérieur à la fin, ou

    • start est un nombre supérieur à la longueur en octets de la chaîne.

  • Dans Amazon DocumentDB 4.0, $indexOfCP renvoie « 0 » lorsque la position de début est un nombre supérieur à la fin ou à la longueur en octets de la chaîne.

  • Avec Amazon DocumentDB 5.0, les opérations de projection dans _id fields, par exemple {"_id.nestedField" : 1}, renvoyez les documents qui incluent uniquement le champ projeté. Alors que dans Amazon DocumentDB 4.0, les commandes de projection de champs imbriquées ne filtrent aucun document.

Compatibilité avec MongoDB 4.0

Fonctionnalités d'Amazon DocumentDB 4.0

Amazon DocumentDB 4.0 a introduit de nombreuses nouvelles fonctionnalités et capacités, notamment des transactions ACID et des améliorations apportées aux flux de modifications. Le résumé ci-dessous présente certaines des principales fonctionnalités introduites dans Amazon DocumentDB 4.0. Pour consulter la liste complète des fonctionnalités, consultez le Notes de version.

  • Transactions ACID: Amazon DocumentDB permet désormais d'effectuer des transactions sur plusieurs documents, relevés, collections et bases de données. Les transactions simplifient le développement d'applications en vous permettant d'effectuer des opérations atomiques, cohérentes, isolées et durables (ACID) sur un ou plusieurs documents au sein d'un cluster Amazon DocumentDB. Pour plus d’informations, consultez Transactions dans Amazon DocumentDB.

  • Modifier les flux: Il est désormais possible d'ouvrir un flux de modifications au niveau du cluster (client.watch() ou mongo.watch()) et la base de données (db.watch()), vous pouvez spécifier un startAtOperationTime pour ouvrir un curseur de flux de modifications, et enfin, vous pouvez désormais étendre la période de rétention de votre flux de modifications à 7 jours (au lieu de 24 heures). Pour plus d’informations, consultez Utilisation des flux de modifications avec Amazon DocumentDB.

  • AWS Database Migration Service (AWS DMS) : Vous pouvez désormais utiliser AWS DMS pour migrer vos charges de travail MongoDB 4.0 vers Amazon DocumentDB. AWS DMS prend désormais en charge une source MongoDB 4.0, une cible Amazon DocumentDB 4.0 et une source Amazon DocumentDB 3.6 pour effectuer des mises à niveau entre Amazon DocumentDB 3.6 et 4.0. Pour plus d'informations, consultez la documentation AWS DMS.

  • Performances et indexation: Vous pouvez désormais utiliser un index avec $lookup, recherchez des requêtes avec une projection contenant un champ ou un champ et le _id le champ peut être servi directement à partir de l'index et sans avoir besoin de lire dans la collection (requête couverte), la possibilité de hint() avec findAndModify, des optimisations de performances pour $addToSet, et des améliorations visant à réduire la taille globale des indices. Pour plus d’informations, consultez Notes de version.

  • Opérateurs: Amazon DocumentDB 4.0 prend désormais en charge un certain nombre de nouveaux opérateurs d'agrégation : $ifNull, $replaceRoot, $setIsSubset, $setIntersection, $setUnion, $setEquals. Vous pouvez consulter toutes les API, opérations et types de données MongoDB que nous prenons en charge sur API, opérations et types de données MongoDB pris en charge dans Amazon DocumentDB.

  • Contrôle d'accès basé sur les rôles (RBAC) : Avec les deux ListCollection et ListDatabase vous pouvez désormais utiliser les commandes facultatives authorizedCollections et authorizedDatabases paramètres permettant aux utilisateurs de répertorier les collections et les bases de données auxquelles ils sont autorisés à accéder sans avoir besoin du listCollections et listDatabase rôles, respectivement. Vous avez également la possibilité de tuer vos propres curseurs sans avoir besoin du KillCursor rôle.

Amazon DocumentDB ne prend pas en charge toutes les fonctionnalités de MongoDB 4.0. Lorsque nous avons créé Amazon DocumentDB 4.0, nous avons travaillé en arrière à partir des fonctionnalités et des fonctionnalités que nos clients nous ont demandé de développer le plus souvent. Nous continuerons à ajouter des fonctionnalités supplémentaires à MongoDB 4.0 en fonction de ce que les clients nous demandent de développer. Par exemple, Amazon DocumentDB 4.0 ne prend actuellement pas en charge les opérateurs de conversion de type ou les opérateurs de chaîne introduits dans MongoDB 4.0. Pour obtenir la liste la plus récente des API prises en charge, consultez API, opérations et types de données MongoDB pris en charge dans Amazon DocumentDB.

Démarrez avec Amazon DocumentDB 4.0

Pour commencer à utiliser Amazon DocumentDB 4.0, consultez le Démarrez avec Amazon DocumentDB. Vous pouvez créer un nouveau cluster Amazon DocumentDB 4.0 à l'aide du Console de gestion AWS ou le AWS KIT DE DÉVELOPPEMENT LOGICIEL, AWS CLI, ou CloudFormation. Lorsque vous vous connectez à Amazon DocumentDB, vous devez utiliser un pilote ou un utilitaire MongoDB compatible avec MongoDB 4.0 ou version ultérieure.

Note

Lors de l'utilisation du AWS KIT DE DÉVELOPPEMENT LOGICIEL, AWS CLI, ou CloudFormation, la version du moteur sera par défaut 5.0.0. Vous devez spécifier explicitement le paramètre engineVersion = 4.0.0 pour créer un nouveau cluster Amazon DocumentDB 4.0 ou engineVersion = 3.6.0 pour créer un nouveau cluster Amazon DocumentDB 3.6. Pour un cluster Amazon DocumentDB donné, vous pouvez déterminer la version du cluster à l'aide du AWS CLI appeler describe-db-clusters ou utilisez la console de gestion Amazon DocumentDB pour afficher le numéro de version du moteur pour un cluster spécifique.

Amazon DocumentDB 4.0 prend en charge r5, r6g, t3.medium, et t4g.medium types d'instances pour vos clusters et est disponible dans toutes les instances prises en charge Régions AWS. L'utilisation d'Amazon DocumentDB 4.0 est gratuite. Pour plus d'informations sur les prix, voir Amazon DocumentDB (avec compatibilité avec MongoDB) Tarification.

Effectuez une mise à niveau ou migrez vers Amazon DocumentDB 4.0

Vous pouvez migrer de MongoDB 3.6 ou MongoDB 4.0 vers Amazon DocumentDB 4.0 à l'aide du AWS DMS ou des utilitaires tels que mongodump, mongorestore, mongoimport et mongoexport. De même, vous pouvez utiliser les mêmes outils pour effectuer la mise à niveau d'Amazon DocumentDB 3.6 vers Amazon DocumentDB 4.0. Pour obtenir des instructions sur la migration, voir Mise à niveau de votre cluster Amazon DocumentDB à l'aide de AWS Database Migration Service.

Différences fonctionnelles

Différences fonctionnelles entre Amazon DocumentDB 3.6 et 4.0

Avec la sortie d'Amazon DocumentDB 4.0, il existe des différences fonctionnelles entre Amazon DocumentDB 3.6 et Amazon DocumentDB 4.0 :

  • Projection pour documents imbriqués: Amazon DocumentDB 3.6 prend en compte le premier champ d'un document imbriqué lors de l'application d'une projection. Cependant, Amazon DocumentDB 4.0 analysera les sous-documents et appliquera également la projection à chaque sous-document. Par exemple : si la projection est "a.b.c": 1, le comportement est alors identique dans les deux versions. Toutefois, si la projection est {a:{b:{c:1}}} alors Amazon DocumentDB 3.6 appliquera la projection uniquement à « a » et non à « b » ou « c ».

  • Comportement pour minKey, maxKey: Dans Amazon DocumentDB 4.0, le comportement de {x:{$gt:MaxKey}} ne renvoie rien, et pour {x:{$lt:MaxKey}} renvoie tout.

  • Différences entre les comparaisons de documents: Comparaison de valeurs numériques de différents types (double, int, long) dans des sous-documents (par exemple, b dans {"_id" :1, "a" :{"b":1}}) fournit désormais une sortie cohérente pour tous les types de données numériques et pour chaque niveau d'un document.

Différences fonctionnelles entre Amazon DocumentDB 4.0 et MongoDB 4.0

Vous trouverez ci-dessous les différences fonctionnelles entre Amazon DocumentDB 4.0 et MongoDB 4.0.

  • Recherche avec une clé vide dans le chemin: Lorsqu'une collection contient un document dont la clé est vide dans le tableau (par ex. {"x" : [ { "" : 10 }, { "b" : 20 } ]}), et lorsque la clé utilisée dans la requête se termine par une chaîne vide (par ex. x.), Amazon DocumentDB renverra ce document puisqu'il parcourt tous les documents du tableau alors que MongoDB ne renverra pas ce document.

  • $setOnInsert ainsi que $ sur le chemin: L'opérateur de terrain $setOnInsert ne fonctionnera pas en combinaison avec $ dans le chemin d'Amazon DocumentDB, qui est également compatible avec MongoDB 4.0.