Python MongoDB- rename()

rename() method in PyMongo is used to rename a collection within a MongoDB database. It allows you to change the name of an existing collection while keeping its data intact. This is useful for reorganizing or updating collection names without losing data.

Syntax

collection.rename(new_name, dropTarget=False)

Parameters:

• new_name: new name for the collection.
• dropTarget (optional): Set to True to overwrite an existing collection with the new name. Default is False.

Let's look at some examples to understand it better.

Example 1:

This example creates a collection and renames it from collection to collec. With dropTarget=True, any existing collec will be overwritten.

Output

collec

Example 2 :

In this example, dropTarget is set to False, so the new collection name must be unique. Since collec already exists, an error will be raised.

Output

pymongo.errors.OperationFailure: target namespace exists

Related Articles:

• find_one_and_update() query
• find_one_and_delete() query
• distinct() query
• sort() query