Docs Menu

Change a Shard Key

The ideal shard key allows MongoDB to distribute documents evenly throughout the cluster while facilitating common query patterns. A suboptimal shard key can lead to uneven data distribution and the following problems:

To address these issues, MongoDB allows you to change your shard key:

  • Starting in MongoDB 5.0, you can reshard a collection by changing a collection's shard key.
  • Starting in MongoDB 4.4, you can refine a shard key by adding a suffix field or fields to the existing shard key.

In MongoDB 4.2 and earlier, a document's shard key is immutable.

For more information on common performance and scaling issues and advice on how to fix them, read Troubleshoot Shard Keys.

Give Feedback
© 2021 MongoDB, Inc.

About

  • Careers
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2021 MongoDB, Inc.