From 346aeeee75416ca6591f6fce1e68a5ccb9e6283d Mon Sep 17 00:00:00 2001 From: Stephanie Aurelio Date: Thu, 6 Feb 2025 13:35:16 -0800 Subject: [PATCH 1/5] update documentdb page --- source/documentdb-support.txt | 80 +++++++++++++++++------------------ 1 file changed, 39 insertions(+), 41 deletions(-) diff --git a/source/documentdb-support.txt b/source/documentdb-support.txt index 2caa54ed6..c28b9907b 100644 --- a/source/documentdb-support.txt +++ b/source/documentdb-support.txt @@ -18,20 +18,11 @@ Amazon DocumentDB Compatibility :backlinks: none :depth: 1 -.. figure:: /figures/documentdb.png - :alt: Amazon DocumentDB logo - -`Amazon DocumentDB (with MongoDB compatibility) `__ -is a fast, reliable, and fully managed database service. Amazon DocumentDB makes it easy -to set up, operate, and scale MongoDB-compatible databases in the cloud. -With Amazon DocumentDB, you can run the same application code and use the same drivers -and tools that you use with MongoDB. - Version Information ------------------- -Amazon DocumentDB supports MongoDB v4.0 and MongoDB v5.0. These versions don't -support all the newer features and functionality in the versions of MongoDB available +Amazon DocumentDB supports MongoDB v4.0 and MongoDB v5.0. These versions don't support all of the +newer features and functionality available in the versions of MongoDB available on `MongoDB Atlas. `__ .. tip:: MongoDB Version History @@ -42,43 +33,54 @@ on `MongoDB Atlas. `__ Compatibility ------------- -As of November 2023, Amazon DocumentDB is about 34 percent compatible with the -MongoDB API. - On Amazon DocumentDB, the following MongoDB features are available in a limited capacity or are not supported at all: -- **Features**: `Capped collections `__, - `map-reduce operations `__, - `GridFS `__, - `text indexes `__, - `partial indexes `__, - `case-insensitive indexes `__ -- **Commands**: ``collMod``, ``createView``, ``filemd5``, ``reIndex``, ``connPoolStats``, - ``dbHash``, ``features``, sharding commands (aside from ``enableSharding`` and +- **Features**: :manual:`Capped collections`, + :manual:`map-reduce operations `, + :manual:`GridFS `, + :manual:`text indexes `, + :atlas:`vector search indexes `, + :manual:`partial indexes `, + :manual:`case-insensitive indexes `, + :manual:`time-series data `, + :manual:`on-demand materialized views `, + :manual:`client-side field level encryption `, + :manual:`queryable encryption` +- **Commands**: ``collMod``, ``collMod:expireAfterSeconds``, ``copydb``, + ``createView``, ``filemd5``, ``reIndex``, ``connPoolStats``, ``dbHash``, + ``features``, ``getLastError``, ``getPrevError``, ``parallelCollectionScan``, + ``resetError``, ``endSessions``, ``killAllSessionsByPattern``, + ``refreshSessions``, sharding commands (aside from ``enableSharding`` and ``shardCollection``) -- **Query Operators**: ``$expr``, ``$text``, ``$where``, ``$meta``, ``$box``, ``$center``, - ``$centerSphere``, ``$polygon``, ``$near`` -- **Aggregation Operators**: ``$accumulator``, ``$count``, ``$ceil``, ``$exp``, ``$floor``, - ``$ln``, ``$log``, ``$log10``, ``$pow``, ``$sqrt``, ``$trunc``, ``$round``, ``$first``, - ``$last``, ``$switch``, ``$binarySize``, ``$bsonSize``, ``$dateFromParts``, - ``$dateToParts``, ``$dateTrunc``, ``$dateDiff``, ``$setDifference``, ``$anyElementTrue``, - ``$allElementsTrue``, ``$ltrim``, ``$rtrim``, ``$trim``, ``$regexFind``, - ``$regexFindAll``, ``$regexMatch``, ``$replaceOne``, ``$replaceAll``, ``$convert``, - ``$toBool``, ``$toDate``, ``$toDecimal``, ``$toDouble``, ``$toInt``, ``$toLong``, - ``$toObjectId``, ``$toString``, ``$isNumber``, ``$rand``, ``$sampleRate``, ``$getField`` -- **Aggregation Stages**: ``$collStats``, ``$facet``, ``$bucket``, ``$bucketAuto``, - ``$sortByCount``, ``$listLocalSessions``, ``$listSessions``, ``$graphLookup`` +- **Query Operators**: ``$expr``, ``$jsonSchema``, ``$text``, ``$where``, + ``$meta``, ``$box``, ``$center``, ``$centerSphere``, ``$polygon``, ``$near``, + ``$uniqueDocs`` +- **Aggregation Operators**: ``$accumulator``, ``$count``, ``$stdDevPop``, + ``$stdDevSamp``, ``$pow``, ``$trunc``, ``$round``, ``$first``, ``$last``, + ``$switch``, ``$binarySize``, ``$bsonSize``, ``$dateFromParts``, + ``$dateToParts``, ``$dateTrunc``, ``$dateDiff``, ``$ltrim``, ``$rtrim``, + ``$trim``, ``$regexFind``, ``$regexFindAll``, ``$regexMatch``, + ``$replaceOne``, ``$replaceAll``, ``$isNumber``, ``$rand``, ``$sampleRate``, + ``$getField`` +- **Aggregation Stages**: ``$collStats``, ``$facet``, ``$bucket``, + ``$bucketAuto``, ``$sortByCount``, ``$unionWith``, ``$set``, + ``$setWindowFields``, ``$unset``, ``$listLocalSessions``, ``$listSessions``, + ``$graphLookup``, ``$merge``, ``$planCacheStats`` +- **Cursor Methods**: ``cursor.collation()``, ``cursor.max()``, + ``cursor.min()``, ``cursor.noCursorTimeout()``, ``cursor.returnKey()``, + ``cursor.showRecordId()``, ``cursor.tailable()`` -In addition, Amazon DocumentDB does not leverage indexes when you perform -queries that contain any of the following operators: +In addition, Amazon DocumentDB does not leverage indexes when performing queries +that contain any of the following operators: - ``$ne`` - ``$nin`` - ``$nor`` - ``$not`` - ``$exists`` -- ``$elemMatch`` +- ``$distinct`` +- ``$elemMatch`` when used in nested queries To learn more about Amazon DocumentDB's compatibility with MongoDB v4.0 and MongoDB v5.0, see the following AWS documentation: @@ -87,10 +89,6 @@ see the following AWS documentation: - `Functional Differences: Amazon DocumentDB and MongoDB `__ - `Supported MongoDB APIs, Operations, and Data Types `__ -For the most current compatibility status between Amazon DocumentDB and MongoDB, see the -`Is Amazon DocumentDB Compatible with MongoDB Atlas? `__ -website. - Support ------- From 30e825cbe952cc9b7a0a364af9f090b5722e3f27 Mon Sep 17 00:00:00 2001 From: Stephanie Aurelio Date: Thu, 6 Feb 2025 14:12:07 -0800 Subject: [PATCH 2/5] edits --- source/documentdb-support.txt | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/source/documentdb-support.txt b/source/documentdb-support.txt index c28b9907b..1e4fe0dc4 100644 --- a/source/documentdb-support.txt +++ b/source/documentdb-support.txt @@ -18,10 +18,13 @@ Amazon DocumentDB Compatibility :backlinks: none :depth: 1 +.. figure:: /figures/documentdb.png + :alt: Amazon DocumentDB logo + Version Information ------------------- -Amazon DocumentDB supports MongoDB v4.0 and MongoDB v5.0. These versions don't support all of the +Amazon DocumentDB claims support for MongoDB v4.0 and MongoDB v5.0. These versions don't support all the newer features and functionality available in the versions of MongoDB available on `MongoDB Atlas. `__ @@ -36,7 +39,7 @@ Compatibility On Amazon DocumentDB, the following MongoDB features are available in a limited capacity or are not supported at all: -- **Features**: :manual:`Capped collections`, +- **Features**: :manual:`Capped collections `, :manual:`map-reduce operations `, :manual:`GridFS `, :manual:`text indexes `, @@ -46,7 +49,7 @@ available in a limited capacity or are not supported at all: :manual:`time-series data `, :manual:`on-demand materialized views `, :manual:`client-side field level encryption `, - :manual:`queryable encryption` + :manual:`queryable encryption ` - **Commands**: ``collMod``, ``collMod:expireAfterSeconds``, ``copydb``, ``createView``, ``filemd5``, ``reIndex``, ``connPoolStats``, ``dbHash``, ``features``, ``getLastError``, ``getPrevError``, ``parallelCollectionScan``, From 9ffeea845ca496664d681b8b30fc6221648dc868 Mon Sep 17 00:00:00 2001 From: Stephanie Aurelio Date: Thu, 6 Feb 2025 14:20:54 -0800 Subject: [PATCH 3/5] cleanup --- source/documentdb-support.txt | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/documentdb-support.txt b/source/documentdb-support.txt index 1e4fe0dc4..739df08b7 100644 --- a/source/documentdb-support.txt +++ b/source/documentdb-support.txt @@ -25,7 +25,7 @@ Version Information ------------------- Amazon DocumentDB claims support for MongoDB v4.0 and MongoDB v5.0. These versions don't support all the -newer features and functionality available in the versions of MongoDB available +newer features and functionality in the versions of MongoDB available on `MongoDB Atlas. `__ .. tip:: MongoDB Version History From 6f896efb11a375d784859556963d678110aba960 Mon Sep 17 00:00:00 2001 From: Stephanie Aurelio Date: Fri, 7 Feb 2025 09:22:59 -0800 Subject: [PATCH 4/5] edits --- source/documentdb-support.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/documentdb-support.txt b/source/documentdb-support.txt index 739df08b7..eb3634ee9 100644 --- a/source/documentdb-support.txt +++ b/source/documentdb-support.txt @@ -24,9 +24,9 @@ Amazon DocumentDB Compatibility Version Information ------------------- -Amazon DocumentDB claims support for MongoDB v4.0 and MongoDB v5.0. These versions don't support all the -newer features and functionality in the versions of MongoDB available -on `MongoDB Atlas. `__ +Amazon DocumentDB claims support for MongoDB v4.0 and MongoDB v5.0. These +versions do not support all the newer features and functionality in the versions +of MongoDB available on :atlas:`MongoDB Atlas `. .. tip:: MongoDB Version History From 2035d1e5a443b5740033760dff57a6f5d9e0a289 Mon Sep 17 00:00:00 2001 From: Stephanie Aurelio Date: Mon, 10 Feb 2025 09:59:46 -0800 Subject: [PATCH 5/5] remove logo --- source/documentdb-support.txt | 3 --- 1 file changed, 3 deletions(-) diff --git a/source/documentdb-support.txt b/source/documentdb-support.txt index eb3634ee9..ab11c313c 100644 --- a/source/documentdb-support.txt +++ b/source/documentdb-support.txt @@ -18,9 +18,6 @@ Amazon DocumentDB Compatibility :backlinks: none :depth: 1 -.. figure:: /figures/documentdb.png - :alt: Amazon DocumentDB logo - Version Information -------------------