In this tutorial, we’ll show you the quickest way to import an entire SQL database to MongoDB using Studio 3T and its new SQL Migration feature.
What you need
Your SQL database connection details. We’ll use MySQL in this tutorial but SQL Server, PostgreSQL, and Oracle are also supported.
Access to SQL Migration. Studio 3T offers a free 30-day trial here.
To illustrate a simple SQL database import, we’ll use the publicly available world database which contains three tables:
- city
- country
- countrylanguage
We’ll import each SQL table to a MongoDB collection, which means we should have three new collections in our target database.
1 – Open SQL Migration
Click on SQL Migration > SQL -> MongoDB Migration in the toolbar.
2 – Choose the source SQL connection
Click on Click here to connect to a server to open SQL Connection Manager.
Open a saved connection
If you’ve already saved a connection, choose your source SQL connection from the list (we’ll use sql-database).
Create a new connection
To create a new SQL connection, click on New Connection, enter the connection details under the Server and SSH tabs, and click Save.
3 – Choose your target MongoDB connection
Like Step 2, click on Click here to connect to a server to choose an existing MongoDB connection or to create a new one.
Here we’ll choose mongodb as our target connection. This is where the three collections will be created.
4 – Choose SQL source tables
Studio 3T calls them “import units”, but an import unit simply means the SQL source table.
Click on Add import units.
We’ll choose the three world tables – city
, country
, and countrylanguage
– to create a collection for each.
By default, Studio 3T will map each table to a collection with the same name.
Click OK. All three tables should appear in the Overview.
5 – Run the SQL import
It’s time to run the SQL import. Click on Run Migration.
Track your import in the Operations window on the bottom-left hand side.
Double-check that the world database was imported in the Connection Tree (top-left).
And finally, double-click on a collection (like country
, highlighted above) to check if the data looks correct (and it does!)
Next steps
The world database is quite simple – requiring no one-to-one or one-to-many table relationships – so the default mappings are sufficient for this import.
Note, however, that SQL Migration lets you fully control these mappings. Learn how to merge multiple SQL tables into one MongoDB collection to find out how you can use SQL Migration to do more complex imports.
If you're working with both MongoDB and SQL, Studio 3T makes it possible to query MongoDB with SQL and easily migrate data between the two databases. Try it out, free for 30 days.
Top comments (1)
Hey kathryn My name is Mohammad Fatha I have some concern regarding Mongify it is also data migrating tool from any relational databse to MongoDB can you please help to ans these questions:
1 . How to ensure the data is not corrupted while migrating ?