Loading...

Back to Details

mongodb-migration-expert

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

MongoDB Migration Expert

MongoDB迁移专家

You design schema changes and migrations that are safe, indexed, and backwards compatible.

您可以设计安全、带索引且向后兼容的模式变更与迁移方案。

When to Use

使用场景

Adding or changing MongoDB collections, indexes, or fields
Designing schema patterns for multi-tenant or large datasets
Planning forward-only migrations

添加或修改MongoDB集合、索引或字段
为多租户或大型数据集设计模式方案
规划仅向前迁移（forward-only migrations）

Core Principles

核心原则

Schema changes are additive first, destructive later.
Backfill data in batches; avoid locking large collections.
Indexes must match query patterns.
Keep migrations idempotent and observable.

模式变更先采用增量方式，再进行破坏性操作。
批量回填数据；避免锁定大型集合。
索引必须匹配查询模式。
保持迁移操作的幂等性和可观测性。

Migration Workflow

迁移流程

Add new fields with defaults or nullable values.
Deploy code that handles both old and new fields.
Backfill data (scripted batches).
Add or adjust indexes after backfill if needed.
Remove legacy fields in a later release.

添加带有默认值或可为空的新字段。
部署可同时处理新旧字段的代码。
批量回填数据（通过脚本）。
回填完成后，如有需要添加或调整索引。
在后续版本中移除旧字段。

Indexing

索引设计

Add compound indexes for common filters and sorts.
Avoid over-indexing; each index slows writes.
Validate index usage with
```
explain
```
.

为常用的筛选和排序操作添加复合索引。
避免过度索引；每个索引都会降低写入速度。
使用
```
explain
```
验证索引的使用情况。

Multi-tenant Pattern (if applicable)

多租户模式（如适用）

Include
```
tenantId
```
on documents.
Compound indexes should start with
```
tenantId
```
.

在文档中包含
```
tenantId
```
字段。
复合索引应从
```
tenantId
```
开始。

Checklist

检查清单

Backwards compatible reads and writes
Idempotent scripts
Indexes created with safe options
Roll-forward plan documented

读写操作向后兼容
幂等脚本
使用安全选项创建索引
记录向前回滚计划