[Build and Deploy Staging Site] Publish from microsoft/azuretipsandtricks-private:main/src/blog

blog/tip317.md

@@ -0,0 +1,109 @@
+---
+type: post
+title: "Tip 317 - How to migrate your MySQL database to the cloud"
+excerpt: "Learn how to migrate your MySQL database to the cloud"
+tags: [Databases]
+share: true
+date: 2021-5-19 12:00:00
+---
+
+::: tip 
+
+:fire:  Checkout the Azure Developer page at [azure.com/developer](https://azure.com/developer?WT.mc_id=azure-azuredevtips-azureappsdev).
+
+:bulb: Learn more : [What is Azure Database for MySQL?](https://docs.microsoft.com/nl-nl/azure/mysql/overview?WT.mc_id=docs-azuredevtips-azureappsdev) 
+
+:tv: Watch the video : [How to migrate your MySQL database to the cloud](https://youtu.be/uxSDpZnFa18?WT.mc_id=youtube-azuredevtips-azureappsdev).
+
+:::
+
+### How to migrate your MySQL database to the cloud
+
+#### Enhance your MySQL security, availability and scalability by running it in Azure
+[MySQL](https://www.mysql.com/?WT.mc_id=other-azuredevtips-azureappsdev) is a very powerful database. When you run it on-premises, you are responsible for keeping it up and running and for securing it and making it as performant as possible. When you run your MySQL database in [Azure Database for MySQL](https://azure.microsoft.com/services/mysql/?WT.mc_id=azure-azuredevtips-azureappsdev), Azure manages it and ensures that it is highly available, performant and secure, so that you can focus on using the database and building valuable applications with it. To get your existing MySQL database into Azure, you need to migrate it. You can [use several tools and techniques to do that](https://datamigration.microsoft.com/?WT.mc_id=microsoft-azuredevtips-azureappsdev), depending on your MySQL version and where you are running it.
+
+In this post, we'll migrate a MySQL database that is running in a [Virtual Machine](https://azure.microsoft.com/services/virtual-machines/?WT.mc_id=azure-azuredevtips-azureappsdev), to a managed MySQL database that runs in an [Azure Database for MySQL](https://azure.microsoft.com/services/mysql/?WT.mc_id=azure-azuredevtips-azureappsdev) server.
+
+#### Prerequisites
+If you want to follow along, you'll need the following:
+* An Azure subscription (If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=azure-azuredevtips-azureappsdev) before you begin)
+* An existing MySQL database that is connected to Azure (with a hybrid connection, like [Azure ExpressRoute](https://azure.microsoft.com/services/expressroute/?WT.mc_id=azure-azuredevtips-azureappsdev), or running in Azure in a Virtual Machine). If you don't have an existing MySQL database, you can create one by installing a [MySQL server](https://www.mysql.com/downloads/?WT.mc_id=other-azuredevtips-azureappsdev) and running [the SQL script in this GitHub repository](https://github.com/Azure/azure-mysql/tree/master/MigrationGuide/sample-app/database-scripts?WT.mc_id=github-azuredevtips-azureappsdev) in a schema on the server
+* [MySQL Workbench](https://www.mysql.com/products/workbench/?WT.mc_id=other-azuredevtips-azureappsdev) that can access the existing MySQL database
+
+#### Migrate to Azure Database for MySQL
+I have a MySQL database that is running in a Virtual Machine in Azure. You might have one that is running on-premises or in another cloud. When that's the case, you need to create a connection between the environment where your MySQL is running and Azure, which is beyond the scope of this article. 
+
+Let's migrate the MySQL database from my VM to Azure Database for MySQL. I'll start by creating an Azure Database for MySQL with the Azure portal. 
+
+1. Go to the [Azure portal](https://portal.azure.com/?WT.mc_id=azure-azuredevtips-azureappsdev)
+2. Click the **Create a resource** button (the plus-sign in the top left corner) 
+3. Search for **mysql**, select the "Azure Database for MySQL" result and click **Create**
+   1. This brings you to the **create MySQL server** blade
+   2. Select a **Resource Group**
+   3. Fill in a **Name** for the server
+   4. Select a **Location**
+   5. Pick a **Version**. For this example, we'll use MySQL version 5.7. You need to make sure that the target server (in Azure), is the same version as the existing MySQL server
+   6. Select the **Compute + Storage tier**
+   7. Fill in an **Admin username** for the server
+   8. Tye a **Password** and **Confirm the password**
+   9. Click **Review + create** and **Create** after that. This creates the Azure Database for MySQL server
+
+<img :src="$withBase('/files/102create.png')">
+
+(Create Azure Database for MySQL in the Azure portal)
+
+We'll use MySQL Workbench to migrate my existing database to the newly created Azure Database for MySQL server. Before you can start to migrate, you need to make sure that you can access the Azure Database for MySQL from MySQL Workbench. In my case, MySQL Workbench is installed on the VM that runs my existing database. So to make sure that I can access the Azure Database for MySQL, I need to go to the **Connection Security** blade of the Azure Database for MySQL in the portal. In there, I can **add the IP address** of my VM to the server firewall and enable the **Allow access to Azure services** setting.
+
+<img :src="$withBase('/files/102configuresecurity.png')">
+
+(Configure Security of the Azure Database for MySQL in the Azure portal)
+
+Let's migrate my existing database to the Azure MySQL database.
+
+1. Open MySQL Workbench
+2. Navigate to the **Database menu** and select **Migration Wizard**. This opens the Migration Wizard
+3. Let's go through the steps in the migration wizard. We'll start by selecting the source MySQL server. This is the existing database. When you've selected it, click **Next**
+
+<img :src="$withBase('/files/102migration1.png')">
+
+(Select the existing database in the migration wizard)
+
+4. Now you need to connect to the Azure Database for MySQL in the **Target Selection**. You can find the details that you need in the **Connection strings blade** of the Azure Database for MySQL
+    1. It is useful to save this connection, so that you can use it later. In the **Stored Connection** drop down listbox, click on **Manage Stored Connections**
+    2. In the Manage DB Connections window, click on **New** to start creating the connection
+    3. Fill in a **Name** for the connection
+    4. Provide the **Hostname** (which will be something like myservername.mysql.database.azure.com)
+    5. Type in the **Username** for the server (something like tipsandtricks@tipsmysql)
+    6. Fill in the **Password** by clicking on **Store in Vault**
+    7. Click **Test Connection** to see if it works. If you can't connect, check you that you correctly typed in your credentials and check the security settings of the Azure Database for MySQL
+    8. When the connection works, click on **Close** to save the connection
+    9. Click **Next** to go to the next step in the wizard
+5. This next step fetches the available schemas to migrate and shows them to you. **Select the schema** of the database that you want to migrate and click **Next**
+6. The wizard now determines the structure of the selected schema. If it passes, click **Next**
+7. In this step, you'll see the artifacts that you can migrate, like Tables and Views. Select what you want to migrate and click **Next**
+8. The objects that will be migrated are now converted into MySQL objects (if they came from a different database type). When it is done, click **Next**
+9. Now you'll see any migration issues that need to be solved. If there are no issues, click **Next**
+10. You can now choose to create and overwrite the schema (if it exists), in the target database. Keep the setting "Create schema in target RDBMS" selected and click **Next**
+11. The schema will now be created in the target database. Once this is done, click **Next**
+12. If the results of the schema creation are okay, click **Next**
+13. In this step, you get to choose how you'll perform the migration. You can do it online, which migrates the data directly, or do it offline, which results in a batch file or script that you can use to migrate the data at a later time. Choose **"Online copy of table data to target RDBMS"** and click **Next**. This starts the migration process
+
+<img :src="$withBase('/files/102migration2.png')">
+
+(Choose the type of data migration in the migration wizard)
+
+14. Once the migration is done, click **Next**
+15. Finally, you see the results of the migration in the Migration Report. This shows how many objects were created and if it was successful. Click **Finish** to close the wizard
+
+<img :src="$withBase('/files/102migration3.png')">
+
+(The Migration report in the migration wizard)
+
+The schema and data is now copied to the Azure Database for MySQL. You can test if it actually succeeded, by opening a connection to the Azure Database for MySQL in MySQL Workbench (with the stored connection that you created in the migration process). Once you are connected, browse through the schema of the database, right-click on a table and click **Select  Rows - Limit 1000**. If this shows the rows of data that you expect, the migration succeeded. In a production scenario, you should create more formal pre- and post-migration tests to validate that the migration was successful. This [migration guide](https://datamigration.microsoft.com/?WT.mc_id=microsoft-azuredevtips-azureappsdev) can help you to plan your migration scenario. 
+
+<img :src="$withBase('/files/102result.png')">
+
+(Query a table in the target database using MySQL Workbench)
+
+#### Conclusion
+When you migrate your MySQL database to Azure, you let Azure take care of running your database and making it highly available, secure, scalable and performant, so that you can focus on building applications that add value. There are several options to migrate a MySQL database to Azure, and in this post, we saw one of them. You can use [Azure Database Migration Guide](https://datamigration.microsoft.com/?WT.mc_id=microsoft-azuredevtips-azureappsdev) to choose the right option for you. Go and check it out!