Question: How do you implement geo sharding in MongoDB?


Geo sharding in MongoDB refers to the process of distributing data across different servers or clusters based on geographic locations to improve query performance and data locality. This approach can be particularly useful for applications that serve a global user base and need to ensure that data relevant to specific regions is stored and accessed more efficiently.

Step 1: Define Location-Based Shard Keys

The first step in implementing geo sharding is to define shard keys that are relevant to your application's geographical data distribution needs. A common approach is to use location identifiers (e.g., country codes, city names, or zip codes) as part of the shard key.

db.collection.createIndex({countryCode: 1, city: 1});

This index could then be used as a shard key to distribute documents across shards based on their countryCode and city.

Step 2: Setup Sharded Cluster

You need to set up a MongoDB sharded cluster if you haven't already. This involves configuring shard instances, config servers, and a query router (mongos).

Step 3: Enable Sharding for Your Database and Collection

After setting up the sharded cluster, enable sharding for your database and then for the collection where you want to apply geo sharding.

sh.enableSharding('yourDatabase') sh.shardCollection('yourDatabase.yourCollection', {'countryCode': 1, 'city': 1})

Step 4: Configure Zone Sharding

MongoDB allows you to associate shards with specific zones and then assign documents to those zones based on the shard key values. This is called zone sharding and is essential for implementing geo sharding effectively.

First, define zones that correspond to different geographic areas:

sh.addShardToZone('shard0000', 'NorthAmerica') sh.addShardToZone('shard0001', 'Europe')

Then, tag ranges of shard key values to the appropriate zones:

sh.updateZoneKeyRange('yourDatabase.yourCollection', {countryCode: 'US', city: MinKey}, {countryCode: 'US', city: MaxKey}, 'NorthAmerica') sh.updateZoneKeyRange('yourDatabase.yourCollection', {countryCode: 'DE', city: MinKey}, {countryCode: 'DE', city: MaxKey}, 'Europe')

This configuration ensures that documents pertaining to different geographic regions are stored on designated shards, improving access speed and efficiency for region-specific queries.


Implementing geo sharding in MongoDB requires careful planning and consideration of how your application's data is distributed geographically. By defining appropriate shard keys and configuring zone sharding, you can significantly improve your application's performance for users around the world.

Was this content helpful?

Start building today

Dragonfly is fully compatible with the Redis ecosystem and requires no code changes to implement.