区域分片:将数据固定到区域
您将定义分片键范围上的区域并将其分配给分片,从而实现数据驻留和地理分区。
区域分片:将数据固定到区域 是 CoddyKit 上的免费 MongoDB Academy 课时。 这是第 4 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 MongoDB Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 MongoDB Academy 课程共包含 4 节课。
本课时的部分内容尚未翻译,以英文显示。
What Is Zone Sharding?
Zone sharding (formerly tag-aware sharding) lets you assign specific shard key ranges to designated groups of shards called zones. Documents whose shard key falls in a zone's range are stored only on the shards belonging to that zone. This enables geographic data residency, hardware-tier affinity, and workload isolation within a single sharded cluster.
Key Use Cases for Zone Sharding
Zone sharding solves several production problems: Data residency — EU GDPR requirements mandate that European user data stays in EU data centers. Tiered storage — keep hot recent data on NVMe shards and cold archive data on slower, cheaper shards. Tenant isolation — in a multi-tenant SaaS application, pin each enterprise customer's data to dedicated shards for noisy-neighbor prevention.
Step 1: Tag Shards With Zone Names
The first step is to assign a zone tag to one or more shards. A shard can belong to multiple zones. Tags are just arbitrary strings you choose. Once tagged, the balancer will only move chunks assigned to a zone tag onto shards that carry that same tag.
// Tag shards with geographic zones
sh.addShardTag('shard-eu-west-1', 'EU')
sh.addShardTag('shard-eu-central-1', 'EU')
sh.addShardTag('shard-us-east-1', 'US')
sh.addShardTag('shard-us-west-2', 'US')Step 2: Define Shard Key Ranges for Zones
Next, define which shard key ranges map to each zone using sh.addTagRange(). This tells the balancer: 'all documents with a shard key in this range must live on shards tagged with this zone.' Use MinKey and MaxKey as open-ended range boundaries.
// Assign EU shard key range to EU zone
sh.addTagRange(
'mydb.users',
{ region: 'EU', userId: MinKey },
{ region: 'EU', userId: MaxKey },
'EU'
)
// Assign US shard key range to US zone
sh.addTagRange(
'mydb.users',
{ region: 'US', userId: MinKey },
{ region: 'US', userId: MaxKey },
'US'
)Shard Key Design for Zone Sharding
Zone sharding requires a compound shard key where the first component is the zone discriminator (e.g., region, tenantId, tier). The second component provides granularity within the zone for further splitting. Example: { region: 1, userId: 1 } — region routes to the right zone; userId allows fine-grained chunk splitting within each zone.
// Shard the collection with a zone-aware compound key
sh.enableSharding('mydb')
sh.shardCollection('mydb.users', { region: 1, userId: 1 })The Balancer Enforces Zone Membership
Once zones are configured, the balancer continuously enforces zone membership. If a chunk with a key in the EU zone range ends up on a US shard (e.g., after adding a shard or changing zone definitions), the balancer migrates it to an EU shard. This migration happens automatically during the next balancer round.
// Monitor that chunks are on the correct zone shards
use config
db.chunks.find(
{ ns: 'mydb.users', 'min.region': 'EU' },
{ shard: 1, min: 1 }
)
// All returned chunks should be on EU-tagged shardsTiered Storage: Hot and Cold Zones
Zone sharding enables tiered storage: assign recent data (e.g., current month) to a 'hot' zone on fast NVMe-backed shards, and older data to a 'cold' zone on slower HDD-backed shards. As data ages, you can update the zone range assignments so the balancer gradually migrates aging chunks from the hot zone to the cold zone.
// Tiered storage by age
sh.addShardTag('shard01', 'HOT')
sh.addShardTag('shard02', 'COLD')
sh.addTagRange('mydb.events',
{ year: 2025, _id: MinKey },
{ year: 2025, _id: MaxKey },
'HOT'
)
sh.addTagRange('mydb.events',
{ year: 2024, _id: MinKey },
{ year: 2024, _id: MaxKey },
'COLD'
)Removing and Updating Zone Ranges
Zone range assignments can be updated to move data as business needs change. Remove an existing range with sh.removeTagRange() and add a new one. The balancer will then migrate the affected chunks to match the new assignment. This is how you roll data from a 'hot' zone to a 'cold' zone monthly.
// Remove an old zone range
sh.removeTagRange(
'mydb.events',
{ year: 2024, _id: MinKey },
{ year: 2024, _id: MaxKey },
'HOT'
)
// Add it to COLD zone instead
sh.addTagRange('mydb.events',
{ year: 2024, _id: MinKey },
{ year: 2024, _id: MaxKey },
'COLD'
)Querying With Zone-Aware Shard Keys
When using a compound zone-aware shard key like { region: 1, userId: 1 }, queries that include the region field are automatically routed to the correct zone's shards. This gives both data residency compliance and query performance — EU queries never touch US shards.
// Query from a EU service — targeted to EU shards only
const user = await db.users.findOne({ region: 'EU', userId: 'u789' })
// mongos routes this to EU-tagged shards only — data never
// leaves EU-region shards even for the query itselfLimitations and Caveats
Zone sharding has some important limitations: 1) It only works with ranged sharding (not hashed sharding with a single field). 2) Documents not covered by any zone range can be balanced to any shard — ensure your ranges cover all possible values using MinKey to MaxKey. 3) Zone migration can take time for large collections; plan migrations during low-traffic windows.
// Ensure all documents are covered by a zone
// Uncovered ranges can land on any shard
sh.addTagRange('mydb.users',
{ region: MinKey, userId: MinKey }, // catch-all
{ region: 'EU', userId: MinKey },
'US' // everything before EU goes to US zone
)Inspecting Zone Configuration
You can inspect the current zone configuration at any time. The zone tags are stored in the config server's config.shards and config.tags collections. sh.status() prints zone information along with chunk distribution, making it easy to verify that the balancer has enforced zone membership correctly.
// View all zone ranges configured for a collection
use config
db.tags.find({ ns: 'mydb.users' })
// Full cluster and zone overview
sh.status()
// Shows: zones, shards in each zone, chunks per shardQuick Check
Test your understanding of MongoDB & NoSQL Databases concepts from this lesson.
Lesson Recap
In this lesson you learned: zone sharding pins shard key ranges to tagged shards for data residency and workload isolation, a compound shard key with a zone discriminator as the first field is required, and the balancer automatically enforces zone membership and migrates chunks when zone assignments change. Next up we explore performance tuning and the database profiler.
用 AI 导师学习 JavaScript — 免费
在浏览器中编写并运行真实代码,获得全天候 AI 导师的即时帮助,并在网页或应用中继续学习。
- 课程
- 30
- 课程
- 120
常见问题解答
「区域分片:将数据固定到区域」课时是免费的吗?
是的 — 「区域分片:将数据固定到区域」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 MongoDB Academy 课程的其余内容,请升级到 CoddyKit PRO。 MongoDB Academy 课程共包含 4 节课。
「区域分片:将数据固定到区域」这节课中我会学到什么?
您将定义分片键范围上的区域并将其分配给分片,从而实现数据驻留和地理分区。 你通过在浏览器中直接运行的动手代码来练习 MongoDB Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 MongoDB Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 MongoDB Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 4 节课,共 4 节。
「区域分片:将数据固定到区域」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 MongoDB Academy 课中编写并运行代码吗?
能。每节 MongoDB Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 分片概念:块、均衡器和分片键
- 选择分片键:基数、频率和单调性
- 范围分片与哈希分片策略
- 区域分片:将数据固定到区域