Amazon claims that migrating from MongoDB to DocumentDB is “as easy as changing the database endpoint to the new Amazon DocumentDB cluster”.
We regularly assess DocumentDB’s compatibility claims by running 6 MongoDB test suites, totaling over 1,100 tests, against DocumentDB’s API emulation. This is the suite that we use to test MongoDB’s conformity and correctness on every database release, and is the best representation of what the full MongoDB API is.
The tests comprise:
● jsCore: nearly 900 tests of MongoDB CRUD operations and database commands
● aggregation: over 200 tests of the MongoDB aggregation pipeline
● jsCore_decimal: evaluates correct behavior of applications using the decimal data type for high precision, fractional numeric data typical in financial and scientific workloads
● change_streams: tests MongoDB change streams, used by developers to build event-driven data pipelines that react in real time to database changes
● jsCore_txns: evaluates correct behavior of multi-document ACID transactions in MongoDB
● jsonSchema: tests the data governance controls provided by MongoDB
65% of all of the correctness tests failed when comparing the DocumentDB API emulation to MongoDB. For developers, this means that:
Any existing MongoDB apps relying on this functionality would need to be re-engineered if they are to be migrated to DocumentDB
Any new apps written against the DocumentDB API only support a subset of MongoDB’s functionality
Any application written for DocumentDB will be locked-in to AWS.
|Number of Tests||Succeeded||Failed|
*Feature not supported by the DocumentDB API emulation
**Tests were run against the MongoDB v4.4 API. Tests of the MongoDB v3.6 API show a 60% failure rate
In terms of functionality, DocumentDB most closely resembles MongoDB 2.6, which was released in 2014. As a result, developers will need to either:
Reimplement required database functionality back in the application tier, slowing down the pace of application development
Move multiple copies of the data into adjacent AWS technologies, with the associated increases in development and operational costs and platform complexity
Key gaps include:
In contrast, Atlas is updated as soon as each new database release is declared as Generally Available, meaning developers don’t have to wait months or years to access the latest platform enhancements. The service is backed by thousands of support engineers, consultants, and solutions architects from MongoDB and the partner ecosystem who offer the benefits of collective MongoDB knowledge acquired supporting tens of thousands of MongoDB customers over the past decade.