JIYIK CN >

With the help of this MongoDB tutorial article, you will learn how to rename a MongoDB database. You will achieve this through two methods.

The following method renames a database in MongoDB.

1. Rename a MongoDB database using the MongoDB GUI
2. Rename the MongoDB database using the MongoDB shell

Rename a MongoDB database using the MongoDB GUI

The following procedure demonstrates how to rename a database in MongoDB using the MongoDB GUI.

1. Duplicate the original database by copying all collections, views, and buckets.
2. Create a new database.
3. Name the new database whatever you want.
4. Paste the copied collections, views, and buckets into the new database.
5. Delete the original database.

In this example, you rename the database user to customers.

(Step 1) Copy the original MongoDB database

Once connected to your MongoDB instance, you will notice a list of databases in the connection tree on the left.

Studio 3T's sophisticated context menus eliminate the need to use the shell to perform basic MongoDB CRUD tasks. In this case, all we want to do is copy the contents of the user database.

You can do this by following the steps below.

1. Right-click User Databases.
2. Click Copy All Collections/Views/Buckets.

If you don't see any copy options, make sure you don't have more than one node selected.

(Step 2) Create a new MongoDB database

Next, you will create a new database where you can paste the copied content. To add a database, follow the steps below.

1. Right-click the target server (in our example, the Studio 3T replica set).
2. Select Add Database....

(Step 3) Name the new database

The Add Database dialog box will pop up. You can name the newly created database customer and click OK.

The customer database will then pop up in the connection tree.

(Step 4) Paste the contents of the original database

Now that you have created the new database, you will follow the below given steps to paste the contents of the original database users into customers.

1. Right-click the Customer database.
2. Select Paste Collection/View/Bucket.

The time this process takes depends on the size of the original database. Progress is always tracked in the operation window, which is located below the connection tree in the lower left corner.

(Step 5) Delete the original MongoDB database

Once you have ensured that everything has been copied correctly to the new database, you can delete the original database user.

1. Right-click the original database.
2. Select Delete database.
3. Click Delete Database.

If you do not have the appropriate user permissions, Studio 3T will display an error notification.

The original database should disappear from the connection tree.

Rename the MongoDB database using the MongoDB Shell

Another method that can be used to rename a MongoDB database is by using the MongoDB shell. Before renaming a database, make sure to back up the database first and confirm the new database before deleting the old one.

Rename using database copy

Connect to MongoDB using the mongo shell.

mongo

The old database contents can be copied to the new database.

db.copyDatabase('old_database', 'new_database')

Before deleting the old database, it is a good idea to double-check that replication was successful. You can delete the old database.

use old_database
db.dropDatabase()

Rename using backup/restore

The mongodump and mongorestore commands can back up an existing database and then restore it into a database with a new name.

mongodump old_database
mongorestore --db new_database ./dump/old_database

Once the copy is confirmed, you can delete the old database. Connect to MongoDB using the mongo shell.

mongo

The old database will be deleted.

use old_database
db.dropDatabase()

With the help of this MongoDB article, we have learned how to rename MongoDB database using different methods. These methods are rename MongoDB database using MongoDB GUI and rename MongoDB database using MongoDB shell.