Microsoft Azure Open Source Development Support Team Blog

Support for Open Source Technologies on Microsoft Azure App Service

Migrating data from On-Premise MySQL Database to ClearDB


Note: Please keep multiple copies of your database when migrating data, so you can fallback if any issues occur.

This blog is to help customers migrate their data from On-Premise MySQL database to ClearDB.

We will use a single self-contained file export to migrate your On-Premise database. You can only use Self-Contained File export for MySQL databases running InnoDB Storage engine. There are multiple ways to export data from your On-Premise Database:

  • Using mysqldump command line utility.
  • Using MySQL Workbench Data Export menu option.
  • Using phpmyadmin, if your application is php based.

Exporting data using mysqldump:

You can run below command to export data from MySQL.

mysqldump –set-gtid-purged=OFF –user=username –host=hostname –protocol=tcp –port=3306 –default-character-set=utf8 –single-transaction=TRUE –routines –events  –password -r “\path\to\dump\file” -n “dbschemaname

All items that are in bold will need to be replaced by the actual values.

Exporting data using MySQL Workbench Data Export menu option:

You will need to download and install MySQL Workbench to export data using this option. Once MySQL Workbench is installed, you can open it and connect to your On-Premise Database and use Server –> Data Export menu option.


This should open up a window to select the schemas or tables that you want to export. Choose all the data you need to export and also select the options selected under “Export Options” and “Objects to Export” sections appropriately.


Once you click on “Start Export”, this should generate a file specified in the “Export to Self-Contained File” section.

Exporting data using phpmyadmin option:

You can export data from phpmyadmin application using the Export tab. After selecting the database you want to export, select “Export Method” as “Custom – display all possible options”. Other than the default checked items, you will need to check only “Add Drop Table/View/Procedure/Function/Event/Trigger Statement” checkbox in “Object creation options”.


Once you click on Go, it will export data and download a file to your PC. This is your database export file.

Once you have exported your data, there are multiple ways to get your data into ClearDB. We will go over these three options:

  • Using MySQL command line utility
  • Using MySQL Workbench
  • Using phpmyadmin, if your application is php based.

Before importing data, you will need to create a ClearDB database from azure portal. Information about ClearDB connection can be found on management portal or the new preview portal.

On Management Portal:


On Preview Portal:


All options will need you to modify the file that was created as part of the export. Open the .sql file created and add this line to the start of the file.

use ‘databaseschemaname’;

databaseschemaname should be the database name that will be created when you create a ClearDB database. You should be able to look it up on management portal under your website dashboard through “view connection strings” link.

Importing data using MySQL command line utility:

MySQL command line utility “mysql” is normally located in your MySQL installation or under MySQL workbench installation. Run below command with proper username, hostname and the path of the sql file created. Also modify the sql file to add use statement at the start.

mysql –u username –p –h hostname < /path/to/sql/file

This should prompt you for the password. Your data should be populated in ClearDB on successful login.

Importing data using MySQL Workbench:

Connect to your ClearDB database using the information provided in Azure management portal. After successful login, open the sql file created during export and execute the file ( after adding use databaseschemaname line). Make sure you select all on the file and then click on execute or place the cursor at the start of the file before clicking on execute. This should import all your data into ClearDB.


Importing data using phpmyadmin:

Login into your phpmyadmin site and browse to Import tab. Browse to the file created during export and run the import. This should import all your data into ClearDB.


This should migrate your data into ClearDB from On-Premise MySQL database.