AWS documentdb documentation change
Summary
Added documentation for MongoDB 8.0 compatibility including new features like query performance improvements, new aggregation stages, text index v2, parallel vector indexing, and migration guidance
Security assessment
The changes primarily document new version compatibility and performance improvements. While collation and views are mentioned (which can have security implications in access control contexts), there is no explicit discussion of security vulnerabilities, patches, or security-specific features. The changes focus on functionality and migration rather than security controls.
Diff
diff --git a/documentdb/latest/developerguide/compatibility.md b/documentdb/latest/developerguide/compatibility.md index b797a7472..3de0b06b2 100644 --- a//documentdb/latest/developerguide/compatibility.md +++ b//documentdb/latest/developerguide/compatibility.md @@ -5 +5 @@ -MongoDB 5.0 compatibilityMongoDB 4.0 compatibility +MongoDB 8.0 compatibilityMongoDB 5.0 compatibilityMongoDB 4.0 compatibility @@ -9 +9 @@ MongoDB 5.0 compatibilityMongoDB 4.0 compatibility -Amazon DocumentDB supports MongoDB compatibility including MongoDB 4.0 and MongoDB 5.0. MongoDB compatibility means that a vast majority of the applications, drivers, and tools you already use today with your MongoDB databases can be used with Amazon DocumentDB with little or no change. This section describes everything you need to know about Amazon DocumentDB compatibility with MongoDB including new capabilities and features, getting started, migrations paths, and functional differences. +Amazon DocumentDB supports MongoDB compatibility including MongoDB 4.0, MongoDB 5.0, and MongoDB 8.0. MongoDB compatibility means that a vast majority of the applications, drivers, and tools you already use today with your MongoDB databases can be used with Amazon DocumentDB with little or no change. This section describes everything you need to know about Amazon DocumentDB compatibility with MongoDB including new capabilities and features, getting started, migrations paths, and functional differences. @@ -12,0 +13,2 @@ Amazon DocumentDB supports MongoDB compatibility including MongoDB 4.0 and Mongo + * MongoDB 8.0 compatibility + @@ -19,0 +22,65 @@ Amazon DocumentDB supports MongoDB compatibility including MongoDB 4.0 and Mongo +## MongoDB 8.0 compatibility + +###### Topics + + * What's new in Amazon DocumentDB 8.0 + + * Get started with Amazon DocumentDB + + * Upgrade or migrate to Amazon DocumentDB 5.0 or 8.0 + + * Functional differences + + + + +### What's new in Amazon DocumentDB 8.0 + +Amazon DocumentDB 8.0 improves query performance by up to 7x, and improves compression ratio by up to 5x, enabling you to build high-performance applications at a lower cost. Amazon DocumentDB 8.0 has full wire protocol compatibility with MongoDB 8.0. The summary below introduces some of major features that were introduced in Amazon DocumentDB 8.0. To see a full list of the new capabilities, see the [Release notes](./release-notes.html). + + * Provides compatibility with MongoDB 8.0 by adding support for MongoDB 8.0 API drivers. Also supports applications that are built using MongoDB API versions 6.0 and 7.0. + + * New query planner in Amazon DocumentDB 8.0 extends performance improvements to aggregation stage operators, along with supporting aggregation pipeline optimizations and distinct commands. + + * Amazon DocumentDB 8.0 supports collation and views. + + * Offers 6 new aggregation stages: $replaceWith, $vectorSearch, $merge, $set, $unset, $bucket, and 3 new aggregation operators $pow, $rand, $dateTrunc. + + * A new version of text index: Text index v2 in Amazon DocumentDB 8.0 introduces additional tokens, enhancing text search capabilities. + + * Through parallel vector index build, Amazon DocumentDB 8.0 reduces index build time by up to 30x. + + + + +### Get started with Amazon DocumentDB 8.0 + +To get started with Amazon DocumentDB 8.0, please see the [Get Started Guide](https://docs.aws.amazon.com/documentdb/latest/developerguide/get-started-guide.html). You can create a new Amazon DocumentDB 8.0 cluster using the AWS Management Console or the AWS SDK, AWS CLI, or AWS CloudFormation. When connecting to Amazon DocumentDB, it is required that you use a MongoDB driver or utility that is compatible with MongoDB 5.0 or higher. + +###### Note + +When using the AWS SDK, AWS CLI, or AWS CloudFormation, the engine version will default to 5.0.0. You must explicitly specify the parameter `engineVersion = 8.0.0` to create a new Amazon DocumentDB 8.0 cluster or `engineVersion = 4.0.0` to create a new Amazon DocumentDB 4.0 cluster or `engineVersion = 3.6.0` to create a new Amazon DocumentDB 3.6 cluster. For a given Amazon DocumentDB cluster, you can determine the cluster version using the AWS CLI to call `describe-db-clusters` or use the Amazon DocumentDB management console to view the engine version number for a particular cluster. + +Amazon DocumentDB 5.0 supports the Amazon EC2 `r8g` Graviton4 processor and Graviton2 processors such as `r6g` and `t4.medium` instance types for your clusters and is available in all supported regions (see [Instances](./what-is.html#what-is-db-instances)). For more information on pricing, see [Amazon DocumentDB (with MongoDB compatibility) Pricing](https://aws.amazon.com/documentdb/pricing/). + +### Upgrade or migrate to Amazon DocumentDB 5.0 or 8.0 + +You can migrate from MongoDB 3.6 or MongoDB 4.0 to Amazon DocumentDB 5.0 or Amazon DocumentDB 8.0 using the [AWS DMS](https://aws.amazon.com/dms/) or utilities like [`mongodump`, `mongorestore`, `mongoimport`, and `mongoexport`](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore-dump_restore_import_export_data.html). For instructions on how to migrate, see [Upgrading your Amazon DocumentDB cluster using AWS Database Migration Service](./docdb-migration.versions.html). + +### Functional differences + +#### Functional differences between Amazon DocumentDB 5.0 and 8.0 + +With the release of Amazon DocumentDB 8.0, there are functional differences between Amazon DocumentDB 5.0 and Amazon DocumentDB 8.0: + + * Planner v1 is the default query planner in Amazon DocumentDB 5.0, whereas the more performant Planner v3 is the default in Amazon DocumentDB 8.0. + + * New features in Amazon DocumentDB 8.0 including Views, Collation and operators like $merge are compatible only with Planner v3. + + * Compression is turned ON by default in Amazon DocumentDB 8.0 and is set to use Zstandard algorithm. Furthermore, in Amazon DocumentDB 8.0 'enabled' is no longer a valid choice; you may select from Zstd, LZ4 and none. + + * Newer capabilities of Amazon DocumentDB 5.0 including Serverless and R8g instances are currently not available in Amazon DocumentDB 8.0. + + + +