Docs Menu
Docs Home
/
MongoDB Manual
/

Ranged Sharding

Range-based sharding involves dividing data into contiguous ranges determined by the shard key values. In this model, documents with "close" shard key values are likely to be in the same chunk or shard. This allows for efficient queries where reads target documents within a contiguous range. However, both read and write performance may decrease with poor shard key selection. See Shard Key Selection.

Diagram of the shard key value space segmented into smaller ranges or chunks.

Range-based sharding is the default sharding methodology if no other options such as those required for Hashed Sharding or zones are configured.

Ranged sharding is most efficient when the shard key displays the following traits:

The following image illustrates a sharded cluster using the field X as the shard key. If the values for X have a large range, low frequency, and change at a non-monotonic rate, the distribution of inserts may look similar to the following:

Diagram of good shard key distribution
click to enlarge

Use the sh.shardCollection() method, specifying the full namespace of the collection and the target index or compound index to use as the shard key.

sh.shardCollection( "database.collection", { <shard key> } )

Important

  • 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, the choice of shard key cannot be changed after sharding.

If you shard a populated collection, only one chunk is created initially. The balancer then migrates ranges from that chunk if necessary according to the configured range size.

If you shard an empty collection:

  • With no zones and zone ranges specified for the empty or non-existing collection:

    • The sharding operation creates a single empty chunk to cover the entire range of the shard key values.

    • After the initial chunk creation, the balancer migrates the initial chunk across the shards as appropriate as well as manages the chunk distribution going forward.

  • With zones and zone ranges specified for the empty or a non-existing collection (Available starting in MongoDB 4.0.3),

    • The sharding operation creates empty chunks for the defined zone ranges as well as any additional chunks to cover the entire range of the shard key values and performs an initial chunk distribution based on the zone ranges. This initial creation and distribution of chunks allows for faster setup of zoned sharding.

    • After the initial distribution, the balancer manages the chunk distribution going forward.

Tip

See also:

To learn how to deploy a sharded cluster and implement ranged sharding, see Deploy a Sharded Cluster.

Back

Hashed Sharding