Navigation
This version of the documentation is archived and no longer supported.

db.collection.renameCollection()

db.collection.renameCollection()

db.collection.renameCollection() provides a helper for the renameCollection database command in the mongo shell to rename existing collections.

Parameters:
  • target (string) – Specifies the new name of the collection. Enclose the string in quotes.
  • dropTarget (boolean) – Optional. If true, mongod will drop the target of renameCollection prior to renaming the collection.

Call the db.collection.renameCollection() method on a collection object, to rename a collection. Specify the new name of the collection as an argument. For example:

db.rrecord.renameCollection("record")

This operation will rename the rrecord collection to record. If the target name (i.e. record) is the name of an existing collection, then the operation will fail.

Consider the following limitations:

The db.collection.renameCollection() method operates within a collection by changing the metadata associated with a given collection.

Refer to the documentation renameCollection for additional warnings and messages.

Warning

The db.collection.renameCollection() method and renameCollection command will invalidate open cursors which interrupts queries that are currently returning data.