Amazon DocumentDB 8.0.2 adds retryable writes and five MongoDB aggregation stages

Amazon DocumentDB 8.0.2 adds retryable writes, five MongoDB aggregation stages and improvements to change streams and query performance. For developers, the release brings practical MongoDB-compatibility changes, including automatic retries for certain transient write errors and new options for analytics and search.

AWS AI Watch analysis

What happened

AWS says DocumentDB 8.0.2 supports retryable writes, which let compatible MongoDB drivers retry certain writes once after a transient error, such as a network interruption or primary failover. On this version, applications no longer need retryWrites=false in the connection string to avoid errors. Retryable writes do not cover updateMany or deleteMany, and remain unsupported on earlier engine versions.

The release also adds $setWindowFields, $bucketAuto, $facet, $graphLookup and correlated $lookup aggregation stages. Change-stream updates include splitting events larger than 16 MB and emitting events for collection and index creation. AWS also lists query-planner improvements, including index-only scans and faster count operations, plus reIndex support for partial indexes.

Why it matters

The retry behaviour could make applications more resilient to brief disruptions without developers having to build that retry logic themselves. The new aggregation stages and change-stream capabilities may also make it easier to move workloads that depend on those MongoDB features, though compatibility still depends on the application’s actual operations.

Our read

This is a substantial database compatibility update, not just a version number with a fresh coat of paint. If you run DocumentDB, check the engine version and the specific commands your application uses before changing connection settings; the exclusions matter. Database upgrades are rarely improved by discovering a compatibility footnote in production.

What to watch

• Whether your cluster is running DocumentDB 8.0.2 or later before enabling retryable writes.
• Whether your driver and workload rely on operations that are excluded from retryable writes.
• Whether the new aggregation and change-stream features cover the MongoDB behaviour your application needs.

Discussion spark: Would improved MongoDB compatibility make you more willing to run a workload on DocumentDB, or do the remaining differences still make migration too costly?

not affiliated with or endorsed by Amazon Web Services (AWS)