Release Notes for MongoDB 5.3
Important
MongoDB 5.3 is a rapid release and is only supported for MongoDB Atlas. MongoDB 5.3 is not supported for use on-premises. For more information, see MongoDB Versioning.
Patch Releases
5.3.2 - Jun 23, 2022
Issues fixed:
-
SERVER-65821 Deadlock during setFCV when there are prepared transactions that have not persisted commit/abort decision
-
SERVER-65429 Balancer defragmentation policy should be cleared on step down
-
SERVER-64403 Find queries with SORT_MERGE collation-encode the missing sort attribute
-
SERVER-63531 commitQuorum incorrectly includes buildIndexes:false nodes and error message incorrectly says that only voting nodes are eligible
-
SERVER-65270 Multi-planned SBE queries involving large documents do not respect the 'sort' option
5.3.1 - April 6, 2022
The first release available for MongoDB 5.3 is 5.3.1. All mentions of MongoDB 5.3 features and updates are available in version 5.3.1.
For a list of all changes in 5.3.0, see:
For a list of all changes in 5.3.1, see:
5.3.0 - Apr 6, 2022
The rest of this page provides the 5.3.0 release notes:
Aggregation
New Aggregation Stages
MongoDB 5.3 introduces the following aggregation stages:
Stage | Description |
---|---|
$fill | Populates null and missing field values within documents.
|
New Aggregation Operators
MongoDB 5.3 introduces the following aggregation operators:
Operator | Description |
---|---|
$linearFill | Fills null and missing fields in a window using linear interpolation based on surrounding field values.
|
setWindowFields
Stage with Transactions and snapshot
Read Concern
Starting in MongoDB 5.3, you can use the $setWindowFields
stage with transactions and the "snapshot"
read concern.
Security
KMIP Key Activation
Starting in MongoDB 5.3, security.kmip.activateKeys
activates all newly created KMIP keys upon creation and then periodically checks that keys are in an active state.
Polling for Active State Keys
Starting in MongoDB 5.3, security.kmip.keyStatePollingSeconds
sets the polling interval in seconds at which mongod
polls the KMIP server for active keys.
Sharding
Limit Rate of Splits and Merges
Starting in MongoDB 5.3, you can use the new chunkDefragmentationThrottlingMS
parameter to limit the rate of split and merge commands run by the balancer when the chunks in a sharded collection are defragmented.
Monitor Defragmentation Status
Starting in MongoDB 5.3, the balancerCollectionStatus
command returns detailed information when run on a namespace going through chunk defragmentation. The output includes the current phase of the defragmentation and how many chunks are left to process.
To see example output, see Ongoing Defragmentation Process.
General Improvements
Time Series Collection Improvements
Starting in MongoDB 5.3, you can use the $geoNear
pipeline operator on any field in a time series collection.
Clustered Collections
Starting in MongoDB 5.3, you can create a collection with a clustered index. Collections created with a clustered index are called clustered collections.
To learn about the benefits compared to a normal collection, see Clustered Collections.
serverStatus
Output Change
Starting in MongoDB 5.3, serverStatus
includes connections.loadBalanced
which reports the number of incoming connections received through a load balancer.
getParameter
can Report When Parameters can be Set
Starting in MongoDB 5.3, getParameter
can report:
-
whether a parameter can be set at startup
-
whether a parameter can be set during runtime
You can use the getParameter
command to report parameter details by passing { showDetails: true }
. You can use getParameter
to report details on all parameters by passing { showDetails: true, allParameters: true }
.
explain
Output Can Includes Fields for Disk Usage on inputStage
Starting in MongoDB 5.3, explain
output can include the following disk usage metrics for a GROUP
explain.executionStats.executionStages.inputStage
that uses the slot-based execution query engine:
-
spilledBytesApprox
, the approximate number of in-memory bytes spilled to disk in the stage -
spilledRecords
, the number of produced records spilled to disk in the stage -
usedDisk
, whether the stage wrote to disk
For details, see explain.executionStats.executionStages.inputStage
.
Specify a Timeout for Step Up and Step Down Operations
Starting in MongoDB 5.3, the fassertOnLockTimeoutForStepUpDown
parameter allows a server that receives a request to step up or down to terminate if it is unable to comply within the timeout.
Multiple Arbiters
Starting in MongoDB 5.3, support for multiple arbiters in a replica set is disabled by default. To enable support for multiple arbiters, start each node with the allowMultipleArbiters
parameter.
Report an Issue
To report an issue, see https://github.com/mongodb/mongo/wiki/Submit-Bug-Reports for instructions on how to file a JIRA ticket for the MongoDB server or one of the related projects.