Release Notes
The release notes section describes the Amazon DocumentDB (with MongoDB compatibility) features, improvements, and bug fixes by release date. With the launch of MongoDB 4.0 compatibility on November 11, 2020, the release notes will include updates for both the Amazon DocumentDB 3.6 and 4.0 engine versions.
You can determine the current Amazon DocumentDB engine version by running the following command:
db.runCommand({getEngineVersion: 1})
If your cluster is not on the latest version of the engine, it is likely that you have pending maintenance available that will upgrade your engine. For more information, see Maintaining Amazon DocumentDB in the Developer Guide.
Topics
February 2, 2023
Bug Fixes and Other Changes
Amazon DocumentDB 3.6 (Engine Version 1.0.208432)
Fixed issue with DML auditing when it is enabled during an ongoing workload.
Fixed issue with DML auditing when aggregate commands with hint is passed a string value.
Fixed issue with
listCollections
command not working when users with readwriteanydatabase role having both authorizedCollections and nameOnly options set to true.Fixed issue to properly parse numeric string in a field name.
Cancel long running cursors when they are impacting garbage collection.
November 30, 2022
New Features
Amazon DocumentDB 4.0 (Engine Version 2.0.7509)
Amazon DocumentDB Elastic Clusters is a new type of Amazon DocumentDB cluster that enables users to leverage the MongoDB sharding APIs to scale out their cluster. Elastic Clusters handle virtually any number of reads and writes with petabytes of storage capacity by distributing the data and compute across multiple underlying compute instances and volumes. To learn more, see Using Amazon DocumentDB Elastic Clusters.
August 9, 2022
New Features
Amazon DocumentDB 3.6 (Engine Version 1.0.208152) and 4.0 (Engine Version 2.0.7509)
-
Added support for Decimal128 data type. The Decimal128 is a BSON data type supported in all regions where DocumentDB is available.
For more information, see Data Types.
-
Added support for DML query auditing with Amazon CloudWatch Logs. Now Amazon DocumentDB can record Data Manipulation Language (DML) events and Data Definition Language (DDL) events to Amazon CloudWatch Logs.
For more information, see this blog post
.
Bug Fixes and other Changes
Amazon DocumentDB (Engine Version 1.0.208152) and 4.0 (Engine Version 2.0.7509)
-
You can now change your own passwoprd with own password with
changeOwnPassword
privilege.
July 25, 2022
New Features
Amazon DocumentDB 3.6 (Engine Version 2.0.7509)
You can now create clusters faster with the ability to create clones that use the same DocumentDB cluster volume and have the same data as the original cluster. For details, see Managing Amazon DocumentDB Clusters.
June 27, 2022
New Features
Amazon DocumentDB 4.0 (Engine Version 2.0.7509)
Amazon DocumentDB dynamically resizes your database based on usage patterns. Adding more data increases the space up to 64 Tebibytes (TiB) and deleting data decreases allotted space.
April 29, 2022
New Features
Amazon DocumentDB is now available in China (Beijing) region. For more information, see
this blog post
April 7, 2022
New Features
Amazon DocumentDB 3.6 (Engine Versions 1.0.207836 and 1.0.208015) and 4.0 (Engine Versions 2.0.6142 and 2.0.6948)
Amazon DocumentDB Performance Insights is now in preview. You can now store seven days of performance history in a rolling window at no additional cost. For more information, see Monitoring with Performance Insights.
March 16, 2022
New Features
Amazon DocumentDB is now available in Europe (Milan) region.
For more information, see this blog post
February 8, 2022
New Features
Amazon DocumentDB R6g and T4g instances are now available in Asia Pacific, South America, and Europe. For more information, see this blog post
January 24, 2022
New Features
Amazon DocumentDB 3.6 (Engine Version 1.0.207684) and 4.0 (Engine Version 2.0.5170)
DocDB; now offers a free trial. For details, see Amazon DocumentDB free trial
page. -
You can now use enhanced features with Geospatial query, including the following APIs:
$geoWithin
$geoIntersects
-
Added support for the following MongoDB operators:
$mergeObjects
$reduce
For more information, see the Querying Geospatial data with Amazon DocumentDB.
January 21, 2022
New Features
Amazon DocumentDB 4.0 (Engine Version 2.0.5706)
-
Amazon DocumentDB Graviton2 (r6g.large, r6g.2xlarge, r6g.4xlarge, r6g.8xlarge, r6g.12xlarge, r6g.16xlarge and t4g.medium) instances are now supported
Amazon DocumentDB 3.6 (Engine Version 1.0.207781) and 4.0 (Engine Version 2.0.5706)
-
Added support for the following MongoDB APIs:
-
$reduce
-
$mergeObjects
-
$geoWithin
-
$geoIntersects
-
October 25, 2021
New Features
Amazon DocumentDB 3.6 (Engine Version 1.0.207780) and 4.0 (Engine Version 2.0.5704)
-
Added support for the following MongoDB APIs
-
$literal
-
$map
-
$$ROOT
-
Support for GeoSpatial Query capabilities. See this blog post
for more details Support for access control with user-defined roles. See this blog post
for more details Amazon DocumentDB JDBC Driver to enable connectivity from BI tools such as Tableau and query tools such as SQL Workbench
Bug fixes and other changes
Amazon DocumentDB 3.6 (Engine Version 1.0.207780) and 4.0 (Engine Version 2.0.5704)
-
Bug fix for
$natural
to sort correctly when an explicit.sort()
is present along with$natural
-
Bug fix for change stream to work with
$redact
-
Bug fix for
$ifNull
to work with empty array -
Bug fix for excessive resource consumption/server crash when a currently logged-in user is deleted or that user’s privilege for an ongoing activity is revoked
-
Bug fix in
listDatabase
andlistCollection
privilege check -
Bug Fix dedupe logic for multi-key elements
June 24, 2021
New Features
Amazon DocumentDB 3.6 (Engine Version 1.0.207117) and 4.0 (Engine Version 2.0.3371)
r5.8xlarge and r5.16xlarge instances are now supported. Learn more at the blog post Amazon DocumentDB Now Supports r5.8xlarge and r5.16xlarge Instances
. Global clusters
are now supported to provide disaster recovery from region-wide outages and enable low-latency global reads by allowing reads from the nearest Amazon DocumentDB cluster.
May 4, 2021
New Features
See all the new features in this blog post
Amazon DocumentDB 3.6 (Engine Version 1.0.207117) and 4.0 (Engine Version 2.0.3371)
renameCollection
$zip
$indexOfArray
$reverseArray
$natural
$hint
support for updateIndex scan for
distinct
Bug fixes and other changes
Amazon DocumentDB 3.6 (Engine Version 1.0.207117) and 4.0 (Engine Version 2.0.3371)
Reduced memory usage for
$in
queriesFixed a memory leak in multikey indexes
Fixed the explain plan and profiler output for
$out
Added a timeout for operations from internal monitoring system to improve reliability
Fixed a defect impacting the query predicates passed to multikey indexes
January 15, 2021
New Features
Amazon DocumentDB 4.0 (Engine Version 2.0.722)
None
Amazon DocumentDB 3.6 (Engine Version 1.0.206295)
Ability to use an index with the
$lookup
aggregation stagefind()
queries with projections can be served direction from an index (covered query)Ability to use
hint()
with thefindAndModify
Performance optimizations for
$addToSet
operatorImprovements to reduce overall index sizes
New aggregation operators:
$ifNull
,$replaceRoot
,$setIsSubset
,$setInstersection
,$setUnion
, and$setEquals
Users can also end their own cursors without requiring the
KillCursor
role
November 9, 2020
New Features
See all the new features in this blog post
Amazon DocumentDB 4.0 (Engine Version 2.0.722)
MongoDB 4.0 compatibility
ACID transactions
Support for
cluster(client.watch()
ormongo.watch())
and the database level(db.watch())
change streamsAbility to start or resume a change streams using
startAtOperationTime
Extend your change stream retention period to 7 days (previously 24 hours)
AWS DMS target for Amazon DocumentDB 4.0
CloudWatch metrics:
TransactionsOpen
,TransactionsOpenMax
,TransactionsAborted
,TransactionsStarted
, andTransactionsCommitted
New fields for transactions in
currentOp
,ServerStatus
, andprofiler
.Ability to use an index with the
$lookup
aggregation stagefind()
queries with projections can be served direction from an index (covered query)Ability to use
hint()
with thefindAndModify
Performance optimizations for
$addToSet
operatorImprovements to reduce overall index sizes.
New aggregation operators:
$ifNull
,$replaceRoot
,$setIsSubset
,$setInstersection
,$setUnion
, and$setEquals
With the
ListCollection
andListDatabase
commands, you can now optionally use theauthorizedCollections
andauthorizedDatabases
parameters to allow users to list the collections and databases that they have permission to access without requiring thelistCollections
andlistDatabase
roles, respectivelyUsers can also end their own cursors without requiring the
KillCursor
roleComparing numeric types of subdocuments is now consistent with comparing numeric types of first-level documents. The behavior in Amazon DocumentDB 4.0 is now compatible with MongoDB.
Amazon DocumentDB 3.6 (Engine Version 1.0.206295)
None
Bug Fixes and Other Changes
Amazon DocumentDB 4.0 (Engine Version 2.0.722)
$setOnInsert
no longer allow updates when using the positional operator$
. The behavior in Amazon DocumentDB 4.0 is now compatible with MongoDB.Fixed issue with
$createCollection
and setautoIndexId
Projection for nested documents
Changed default setting for working memory to scale with instance memory size
Garbage collection improvements
Lookup with empty key in path, behavior difference with mongo
Fixed
dateToString
bug in timezone behaviorFixed
$push
(aggregation) to respect sort orderFixed bug in
$currentOp
with aggregateFixed issue with
readPreference
on secondaryFixed issue with validating
$createIndex
is the same database as the command was issuedFixed inconsistent behavior for
minKey
,maxKey
lookup failsFixed issue with
$size
operator not working with composite arrayFixed issue with the negation of
$in
with regexFixed issue with
$distinct
command run against a viewFixed issue with aggregations and find commands sorting missing fields differently
Fixed
$eq
to regular expression not checking typeFixed
$currentDate
bug in timestamp ordinal position behaviorFixed millisecond granularity for
$currentDate
Amazon DocumentDB 3.6 (Engine Version 1.0.206295)
None
October 30, 2020
New Features
See all the new features in this blog post
Amazon DocumentDB 3.6 (Engine Version 1.0.206295)
Added the ability to open a change stream cursor at the cluster level
(client.watch()
ormongo.watch())
and the database(db.watch())
Ability to increase the change stream retention period to 7 days(previously 24 hours)
Bug Fixes and Other Changes
Amazon DocumentDB 3.6 (Engine Version 1.0.206295)
Various general case performance improvements
A targeted security improvement
Fixed an issue with skip sort on second field of a compound index
Enable regular index for equality on single field of a multi-key index (not compound)
Fixed authentication race condition
Fixed issue that caused an infrequent garbage collection crash
RBAC security improvement
Added
databaseConnectionsMax
metricPerformance improvements for certain workloads on
r5.24xlarge
instances
September 22, 2020
New Features
See all the new features in this blog post
Amazon DocumentDB 3.6 (Engine Version 1.0.206295)
$out
aggregation stageIncreased the maximum number of connections and cursor per instance by as much as 10x
Bug Fixes and Other Changes
Amazon DocumentDB 3.6 (Engine Version 1.0.206295)
None
July 10, 2020
New Features
See all the new features in this blog post
Amazon DocumentDB 3.6 (Engine Version 1.0.206295)
Cross Region Snapshot Copy
Bug Fixes and Other Changes
Amazon DocumentDB 3.6 (Engine Version 1.0.206295)
None
June 30, 2020
New Features
See all the new features in this blog post
Amazon DocumentDB 3.6 (Engine Version 1.0.206295)
T3 medium instances
Bug Fixes and Other Changes
Amazon DocumentDB 3.6 (Engine Version 1.0.206295)
Idle memory reclamation for t3 instances
Authentication improvements
Improved SASL authentication performance
Fixed
currentOp
issue when exceeding maximum possible opsFixed
killOps
issue for bulk update and deleteImprovements to
$sample
performance with$match
Fixed support for
$$
in cond case in redact stageFixed various recurring crash root causes
Improvements to TTL sweeping to reduce IOs and latency
Optimized memory utilization for
$unwind
Fixed collection stats race condition with drop index
Fixed race condition during concurrent index build
Fixed infrequent crash in
hash_search
in index