db.collection.renameCollection（）

参考 > 参考 > mongo Shell方法 > 收集方法 > db.collection.renameCollection（）

在本页面

定义¶

db.collection.renameCollection（target，dropTarget ）¶

mongo 壳法

此页面记录了mongoshell方法，并且没有引用MongoDB Node.js驱动程序（或任何其他驱动程序）方法。对于相应的MongoDB驱动程序API，请改为参考您特定的 MongoDB驱动程序文档。

重命名集合。提供数据库命令的包装。renameCollection

参数	类型	描述
`target`	串	集合的新名称。将字符串用引号引起来。请参阅命名限制。
`dropTarget`	布尔值	可选的。如果`true`，`mongod`下降到目标的`renameCollection`前重命名集合。默认值为`false`。

该db.collection.renameCollection()方法通过改变与给定集合相关联的元数据在集合内操作。

renameCollection有关其他警告和消息，请参考文档。

警告

该db.collection.renameCollection()方法和 renameCollection命令将使打开的游标无效，该游标会中断当前正在返回数据的查询。

对于变更流，该 db.collection.renameCollection()方法和 renameCollection命令为在源或目标集合上打开的任何现有变更流创建一个无效事件。

该方法具有以下局限性：
- db.collection.renameCollection()无法在数据库之间移动集合。使用renameCollection这些重命名操作。
- db.collection.renameCollection() 分片集合不支持。
- 您不能重命名视图。

在版本4.2中进行了更改。

renameCollection()在操作期间获得对源集合和目标集合的排他锁。集合上的所有后续操作都必须等到 renameCollection()完成。在MongoDB 4.2之前的版本中，renameCollection需要获得独占数据库锁才能重命名同一数据库中的集合。

一mongodump开始 --oplog，如果客户的问题未能 db.collection.renameCollection()在转储过程。请参阅以获取更多信息。mongodump --oplog

db.collection.renameCollection()在集合对象上调用该方法。例如：

db.rrecord.renameCollection("record")

此操作会将rrecord集合重命名为record。如果目标名称（即record）是现有集合的名称，则该操作将失败。