Live resharding was one of the key enhancements delivered in our MongoDB 5.0 Major Release. With live resharding you can change the shard key for your collection on demand as your application evolves with no database downtime or complex data migrations.
In this blog post, we will be covering:
-
Product developments that have made sharding more flexible
-
What you had to do before MongoDB 5.0 to reshard your collection, and how that changed with 5.0 live resharding
-
Guidance on the performance and operational considerations of using live resharding
Before that, we should discuss why you should shard at all, and the importance of selecting a good shard key – even though you have the flexibility with live resharding to change it at any time. Go ahead and skip the next couple of sections if you are already familiar with sharding!
Why Shard your Database?
Sharding enables you to distribute your data across multiple nodes. You do that to:
-
Scale out horizontally — accommodate growing data or application load by sharding once your application starts to get close to the capacity limits of a single replica set.
-
Enforce data locality — for example pinning data to shards that are provisioned in specific regions so that the database delivers low latency local access and maintains data sovereignty for regulatory compliance.
Sharding is the best way of scaling databases and MongoDB was developed to support sharding natively. Sharding MongoDB is transparent to your applications and it’s elastic so you can add and remove shards at any time.
The Importance of Selecting a Good Shard Key
MongoDB’s native sharding has always been highly flexible — you can select any field or combination of fields in your documents to shard on. This means you can select a shard key that is best suited to your application’s requirements.
The choice of shard key is important as it defines how data is distributed across the available shards. Ideally you want to select a shard key that:
-
Gives you low latency and high throughput reads and writes by matching data distribution to your application’s data access patterns.
-
Evenly distributes data across the cluster so you avoid any one shard taking most of the load (i.e., a “hot shard”).
-
Provides linear scalability as you add more shards in the future.
While you have the flexibility to select any field(s) of your documents as your shard key, it was previously difficult to change the shard key later on. This made some developers fearful of sharding. If you chose a shard key that doesn’t work well, or if application requirements change and the shard key doesn’t work well for its changed access patterns, the impact on performance could be significant.
At this point in time, no other mainstream distributed database allows users to change shard keys, but we wanted to give users this ability.
Making Shard Keys More Flexible
Over the past few releases, MongoDB engineers have been working to provide more sharding flexibility to users:
-
MongoDB 4.2 introduced the ability to modify a shard key’s value. Under the covers the modification process uses a distributed, multi-document ACID transaction to change the placement of a document in a sharded cluster. This is useful when you want to rehome a document to a different geographic region or age data out to a slower storage tier.
-
MongoDB 4.4 went further with the ability to refine the shard key for a collection by adding a suffix to an existing key.
Both of these enhancements made sharding more flexible, but they didn’t help if you needed to reshard your collection using an entirely different shard key.
Manual Resharding: Before MongoDB 5.0
Resharding a collection was a manual and complex process that could only be achieved through one of two approaches:
- Dumping the entire collection and then reloading it into a new collection with the new shard key. This is an offline process, and so your application is down until data reloading is complete — for example, it could take several days to dump and reload a 10 TB+ collection on a three-shard cluster.
- Undergoing a custom migration that involved writing all the data from the old cluster to a new cluster with the resharded collection. You had to write the query routing and migration logic, and then constantly check the migration progress to ensure all data had been successfully migrated. Custom migrations entail less downtime, but they come with a lot of overhead. They are highly complex, labor-intensive, risky, and expensive (as you had to run two clusters side-by-side). It took one MongoDB user three months to complete the live migration of 10 billion documents.
How this Changed with MongoDB 5.0: Live Resharding
We made manual resharding a thing of the past with MongoDB 5.0. With 5.0 you just run the reshardCollection command from the shell, point at the database and collection you want to reshard, specify the new shard key, and let MongoDB take care of the rest.
reshardCollection: "<database>.<collection>", key: <shardkey>

When you invoke the reshardCollection
command, MongoDB clones your existing collection into a new collection with the new shard key, then starts applying all new oplog updates from the existing collection to the new collection. This enables the database to keep pace with incoming application writes. When all oplog updates have been applied, MongoDB will automatically cut over to the new collection and remove the old collection in the background.
Lets walk through an example where live resharding would really help a user:
-
The user has an orders collection. In the past, they needed to scale out and chose the
order_id field
as the shard key. -
Now they realize that they have to regularly query each customer’s orders to quickly display order history. This query does not use the
order_id
field. To return the results for such a query, all shards need to provide data for the query. This is called a scatter-gather query. -
It would have been more performant and scalable to have orders for each customer localized to a shard, avoiding scatter-gather, cross-shard queries.
-
They realize that the optimal shard key would be
"customer_id: 1, order_id: 1"
rather than just theorder_id
.
With MongoDB 5.0’s live resharding, the user can just run the reshard command, and MongoDB will reshard the orders collection for them using the new shard key, without having to bring the database and the application down.
Watch our short Live Resharding talk from MongoDB.Live 2021 to see a demo with this exact example.
Not only can you change the field(s) for a shard key, you can also review your sharding strategy, changing between range, hash, and zones.
Live Resharding: Performance and Operational Considerations
Even with the flexibility that live resharding gives you, it is still important to properly evaluate the selection of your shard key. Our documentation provides guidance to help you make the best choice of shard key. Of course, live resharding makes it much easier to change that key should your original choice have not been optimal, or if your application changes in a way that you hadn’t previously anticipated. If you find yourself in this situation, it is essential to plan for live resharding.
What do you need to be thinking about before resharding
Make sure you have sufficient storage capacity available on each node of your cluster. Since MongoDB is temporarily cloning your existing collection, spare storage capacity needs to be at least 1.2x the size of the collection you are going to reshard. This is because we need 20% more storage in order to buffer writes that occur during the resharding process. For example, if the size of the collection you want to reshard is 2 TB compressed, you should have at least 2.4 TB of free storage in the cluster before starting the resharding operation.
While the resharding process is efficient, it will still consume additional compute and I/O resources. You should therefore make sure you are not consistently running the database at or close to peak system utilization. If you see CPU usage in excess of 80% or I/O usage above 50%, you should scale up your cluster to larger instance sizes before resharding. Once resharding is done, it's fine to scale back down to regular instance sizes.
Before you run resharding, you should update any queries that reference the existing shard key to include both the current shard key and the new shard key. When resharding is complete, you can remove the old shard key from your queries.
Review the resharding requirements documentation for a full run down on the key factors to consider before resharding your collection.
What should you expect during resharding?
Total duration of the resharding process is dependent on the number of shards, the size of your collection, and the write load to your collection. For a constant data size, the more shards the shorter the resharding duration.
From a simple POC on MongoDB Atlas, a 100 GB collection took just 2 hours 45 minutes to reshard on a 4-shard cluster and 5 hours 30 minutes on a 2-shard cluster. The process scales up and down linearly with data size and number of shards – so a 1 TB collection will take 10 times longer to reshard than a 100GB collection. Of course your mileage may vary based on the read/write ratio of your application along with the speed and quality of your underlying hardware infrastructure.
While resharding is in flight, you should expect the following impacts to application performance:
-
The latency and throughput of reads against the collection that is being resharded will be unaffected.
-
Even though we are writing to the existing collection and then applying oplog entries to both its replicas and to the cloned collection, you should expect to see negligible impact to write latency given enough spare CPU. If your cluster is CPU-bound, expect a latency increase of 5 to 10% during the cloning phase and 20 to 50% during the applying phase (*).
-
As long as you meet the aforementioned capacity requirements, the latency and throughput of operations to other collections in the database won't be impacted.
(*) Note: If you notice unacceptable write latencies to your collection, we recommend you stop resharding, increase your shard instance sizes, and then run resharding again. The abort and cleanup of the cloned collection are instantaneous.
If your application has time periods with less traffic, reshard your collection during that time if possible.
All of your existing isolation, consistency, and durability guarantees are honored while resharding is running. The process itself is resilient and crash-safe, so if any shard undergoes a replica set election, there is no impact to resharding – it will simply resume when the new primary has been elected.
You can monitor the resharding progress with the $currentOp pipeline stage. It will report an estimate of the remaining time to complete the resharding operation. You can also abort the resharding process at any time.
What happens after resharding is complete?
When resharding is done and the two collections are in sync, MongoDB will automatically cut over to the new collection and remove the old collection for you, reclaiming your storage and returning latency back to normal.
By default, cutover takes up to two seconds — during which time the collection will not accept writes, and so your application will see a short spike in write latency. Any writes that timeout are automatically retried by our drivers, so exceptions are not surfaced to your users. The cutover interval is tunable:
-
Resharding will be quicker if you raise the interval above the two second default, with the trade-off that the period of write unavailability will be longer.
-
By dialing it down below two seconds, the interval of write unavailability will be shorter. However, the resharding process will take longer to complete, and the odds of the window ever being short enough to cutover will be diminished.
You can block writes early to force resharding to complete by issuing the commitReshardCollection
command. This is useful if the current time estimate to complete the resharding operation is an acceptable duration for your collection to block writes.
What you Get with Live Resharding
Live sharding is available wherever you run MongoDB – whether that’s in our fully managed Atlas application data platform in the cloud, with Enterprise Advanced, or if using the Community Edition of MongoDB.
To recap how you benefit from live resharding:
-
Evolve with your apps with simplicity and resilience: As your applications evolve or as you need to improve on the original choice of shard key, a single command kicks off resharding. This process is automated, resilient, and non-disruptive to your application.
-
Compress weeks/months to minutes/hours: Live resharding is fully automated, so you eliminate disruptive and lengthy manual data migrations. To make scaling out even easier, you can evaluate the effectiveness of different shard keys in dev/test environments before committing your choice to production. Even then, you can change your shard key when you want to.
-
Extend flexibility and agility across every layer of your application stack: You have seen how MongoDB’s flexible document data model instantly adapts as you add new features to your app. With live resharding you get that same flexibility when you shard. New features or new requirements? Simply reshard as and when you need to.
Summary
Live Resharding is a huge step forward in the state of distributed systems, and is just the start of an exciting and fast-paced MongoDB roadmap that will make sharding even easier, more flexible, and automated.
If you want to dig deeper, please take a look at the Live Resharding session recording from our developer conference and review the resharding documentation.
To learn more about MongoDB 5.0 and our new Rapid Releases, download our guide to what’s new in MongoDB.