在数据库的日常维护和业务迭代中，集合的重命名是一个常见需求。比如项目初期命名不规范，后期需要统一调整；或者按月份分表存储的数据，在归档时需要转移到专门的归档库。MongoDB提供了$renameCollection这一聚合阶段，可以在服务端直接完成集合改名，无需把数据读到客户端再写回去，对于大集合来说这种方式效率优势非常明显。本文将围绕该操作的语法、使用场景和注意事项展开详细说明。
$renameCollection的基本语法与参数说明
$renameCollection是一个聚合阶段命令，它的标准调用方式是使用db.runCommand执行一个包含from和to两个核心参数的命令对象。from指定源集合的完整命名空间，格式为数据库名.集合名；to指定目标命名空间，即重命名后的位置。这两个参数都是必填项，缺一不可。
下面是基本的命令写法：
// 在源数据库上执行重命名操作
db.adminCommand({
renameCollection: "olddb.user_data",
to: "newdb.users"
})注意这里用的是db.adminCommand而不是db.runCommand。因为重命名集合属于管理类操作，必须在admin数据库上执行，如果在普通数据库上直接runCommand，会返回权限错误。from和to中的数据库名可以相同，也可以不同，这正是跨库移动集合的基础。
除了必填的from和to之外，该命令还支持一个可选参数dropTarget。当目标命名空间已经存在同名集合时，默认情况下命令会直接报错并终止，错误信息中会明确提示目标集合已存在。如果将dropTarget设置为true，MongoDB会先删除已存在的目标集合，再完成重命名。这个参数威力较大，使用前务必确认目标集合中的数据确实可以丢弃，否则会造成不可恢复的数据损失。
同一数据库内重命名与跨库重命名的实践
同一数据库内的重命名是最简单的场景。假设我们有一个命名为tmp_2024_log的临时集合，现在需要正式命名为server_log，可以先切换到admin库再执行命令，也可以在任意库上通过adminCommand执行，因为adminCommand本身就会路由到admin数据库。
// 同库重命名
db.adminCommand({
renameCollection: "appdb.tmp_2024_log",
to: "appdb.server_log"
})执行成功后返回的结果中ok字段的值为1，表示操作完成。如果返回错误，常见的排查方向包括：源集合是否存在、当前用户是否具备renameCollection角色权限、目标集合是否已经存在。特别是权限问题，普通读写角色无法执行重命名，需要具备dbAdmin或者在源库和目标库上都有读写权限的角色。
跨库重命名的写法完全一致，只需要让to参数指向另一个数据库即可。这在数据归档场景中特别实用。例如把业务库中三年前的历史订单集合整体搬到archive库，一条命令就能完成，数据不会离开MongoDB服务端，避免了网络传输开销。需要注意的是，跨库重命名要求执行账号在两个数据库上都有相应权限，而且如果两个库分布在不同的分片集群上，操作将无法执行。
// 跨库归档历史数据
db.adminCommand({
renameCollection: "business.orders_history",
to: "archive.orders_2022"
})顺带一提，除了直接执行命令，MongoDB还提供了db.collection.renameCollection()这个shell辅助方法，用法更简洁，但它仅支持同库重命名，不支持跨库操作，底层本质还是同一个命令。
分片集群与副本集环境下的注意事项
在副本集环境中，$renameCollection的操作会自动同步到从节点，主从数据保持一致，这一点无需担心。但要注意执行时机，重命名过程中集合会被短暂锁定，如果业务高峰期对大集合执行该操作，可能出现请求排队，建议安排在低峰期执行。
分片集群的限制则多得多。对于已经分片的集合，MongoDB从4.2版本开始才支持重命名操作，而且要求目标集合名不能已经存在分片元数据，同时源集合所在数据库不能正在进行其他元数据变更操作。如果版本较低或者不满足条件，会收到错误提示。此外，跨数据库重命名分片集合时，两个数据库必须位于同一个分片集群内，且不能跨越不同的分片键配置。
还有一个容易踩的坑：如果集合上存在变更流或者正在进行的索引构建，重命名操作可能失败或导致变更流断开。生产环境执行前，最好先确认没有依赖该集合名的应用连接，比如某些驱动在连接字符串中写死了集合名，改名后这些应用会立刻报集合不存在的错误。稳妥的做法是先在测试环境演练，再在业务低峰期操作，并提前准备好回滚方案，也就是准备好反向的重命名命令，一旦出现问题可以快速恢复。
总体来看，$renameCollection是一个高效且安全的服务端集合改名方案，核心命令只需要两个参数，掌握好dropTarget的使用边界以及分片环境下的限制条件，就能在绝大多数运维场景中得心应手地使用它。