DOCSP-34448 - DocumentDB comparison page

source/documentdb-support.txt

@@ -0,0 +1,84 @@
+.. _documentdb-support:
+
+===============================
+Amazon DocumentDB Compatibility
+===============================
+
+.. facet::
+   :name: genre
+   :values: reference
+
+.. meta:: 
+   :keywords: AWS, support
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+
+.. figure:: /figures/documentdb.png
+   :alt: Amazon DocumentDB logo
+
+`Amazon DocumentDB (with MongoDB compatibility) <https://docs.aws.amazon.com/documentdb/latest/developerguide/what-is.html>`__
+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 lack
+support for the newer features and functionality in the versions of MongoDB available
+on `MongoDB Atlas. <https://www.mongodb.com/docs/atlas/>`__
+
+.. tip:: MongoDB Version History
+
+   To learn more about the features available in each version of MongoDB, see 
+   `MongoDB Evolved - Version History. <https://www.mongodb.com/evolved>`__
+
+Compatibility
+-------------
+
+As of November 2023, Amazon DocumentDB is only about 34 percent compatible with the
+MongoDB API.
+On Amazon DocumentDB, the following MongoDB features are
+available only in a limited capacity or are not supported at all:
+
+- Features: `Capped collections <https://www.mongodb.com/docs/manual/core/capped-collections/>`__,
+  `map-reduce operations <https://www.mongodb.com/docs/v7.0/core/map-reduce/>`__,
+  `GridFS <https://www.mongodb.com/docs/manual/core/gridfs/>`__,
+  `text indexes <https://www.mongodb.com/docs/manual/core/indexes/index-types/index-text/>`__,
+  `partial indexes <https://www.mongodb.com/docs/manual/core/index-partial/>`__,
+  `case-insensitive indexes <https://www.mongodb.com/docs/manual/core/index-case-insensitive/>`__
+- Commands: ``collMod``, ``createView``, ``filemd5``, ``reIndex``, ``connPoolStats``,
+  ``dbHash``, ``features``, 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``
+
+To learn more about Amazon DocumentDB's compatibility with MongoDB v4.0 and MongoDB v5.0,
+see the following AWS documentation:
+
+- `MongoDB Compatibility <https://docs.aws.amazon.com/documentdb/latest/developerguide/compatibility.html#mongodb-50>`__
+- `Functional Differences: Amazon DocumentDB and MongoDB <https://docs.aws.amazon.com/documentdb/latest/developerguide/functional-differences.html>`__
+- `Supported MongoDB APIs, Operations, and Data Types <https://docs.aws.amazon.com/documentdb/latest/developerguide/mongo-apis.html>`__
+
+For the most current compatibility status between Amazon DocumentDB and MongoDB, see
+`Is Amazon DocumentDB Compatible with MongoDB Atlas? <https://www.isdocumentdbreallymongodb.com/>`__
+
+Support
+-------
+
+MongoDB doesn't offer commercial support for Amazon DocumentDB. For help with this product,
+contact AWS Support directly.

source/index.txt

@@ -141,8 +141,15 @@ Featured Community-Supported Libraries
       :icon: /icons/r.svg
       :icon-alt: R icon
 
-Don’t see your desired language? Browse more `community-supported libraries <https://github.com/ramnes/awesome-mongodb#libraries>`__.
+Don't see your desired language? Browse more `community-supported libraries <https://github.com/ramnes/awesome-mongodb#libraries>`__.
 
+Comparison with Other Document Databases
+----------------------------------------
+
+See the following pages to learn about the differences between MongoDB and other
+document databases:
+
+- :ref:`documentdb-support`
 
 .. toctree::