Refresh mysql-to-sql-server.md

Author: rwestMSFT

docs/sql-server/migrate/guides/mysql-to-sql-server.md

@@ -1,15 +1,14 @@
 ---
 title: "MySQL to SQL Server: Migration guide"
-description: 'This guide teaches you how to migrate your MySQL databases to Microsoft SQL Server by using SQL Server Migration Assistant for MySQL (SSMA for MySQL).'
+description: "This guide teaches you how to migrate your MySQL databases to Microsoft SQL Server by using SQL Server Migration Assistant for MySQL (SSMA for MySQL)."
+author: MashaMSFT
+ms.author: mathoma
+ms.reviewer: randolphwest
+ms.date: 01/20/2023
 ms.service: sql
-ms.reviewer: ""
 ms.subservice: migration-guide
 ms.topic: how-to
-author: MashaMSFT
-ms.author: mathoma
-ms.date: 10/05/2021
-ms.custom:
-  - intro-migration
+ms.custom: intro-migration
 ---
 
 # Migration guide: MySQL to SQL Server
@@ -18,7 +17,7 @@ ms.custom:
 
 In this guide, you learn how to migrate your MySQL databases to SQL Server.
 
-For other migration guides, see [Azure Database Migration Guides](/data-migration). 
+For other migration guides, see [Azure Database Migration Guides](/data-migration).
 
 ## Prerequisites
 
@@ -42,25 +41,25 @@ To create an assessment:
 1. On the **File** menu, select **New Project**.
 1. Enter the project name and a location to save your project and the migration target. Then select **SQL Server** in the **Migrate To** option.
 
-   ![Screenshot that shows New Project.](./media/mysql-to-sql-server/new-project.png)
+   :::image type="content" source="./media/mysql-to-sql-server/new-project.png" alt-text="Screenshot that shows New Project option.":::
 
 1. In the **Connect to MySQL** dialog box, enter connection details, and then connect to your MySQL server.
 
-   ![Screenshot that shows Connect to MySQL.](./media/mysql-to-sql-server/connect-to-mysql.png)
+   :::image type="content" source="./media/mysql-to-sql-server/connect-to-mysql.png" alt-text="Screenshot that shows Connect to MySQL option.":::
 
 1. Select the MySQL databases you want to migrate.
 
-   ![Screenshot that shows selecting the MySQL database you want to migrate.](./media/mysql-to-sql-server/select-database.png)
+   :::image type="content" source="./media/mysql-to-sql-server/select-database.png" alt-text="Screenshot that shows selecting the MySQL database you want to migrate.":::
 
 1. Right-click the MySQL database in **MySQL Metadata Explorer**, and select **Create Report**. Alternatively, you can select the **Create Report** tab in the upper-right corner.
 
-   ![Screenshot that shows Create Report.](./media/mysql-to-sql-server/create-report.png)
+   :::image type="content" source="./media/mysql-to-sql-server/create-report.png" alt-text="Screenshot that shows Create Report feature.":::
 
 1. Review the HTML report to understand conversion statistics and any errors or warnings. You can also open the report in Excel to get an inventory of MySQL objects and the effort required to perform schema conversions. The default location for the report is in the report folder within SSMAProjects, as shown here:
 
     `drive:\Users\<username>\Documents\SSMAProjects\MySQLMigration\report\report_2016_11_12T02_47_55\`.
-   
-   ![Screenshot that shows a conversion report.](./media/mysql-to-sql-server/conversion-report.png)
+
+   :::image type="content" source="./media/mysql-to-sql-server/conversion-report.png" alt-text="Screenshot that shows a conversion report.":::
 
 ### Validate the type mappings
 
@@ -69,7 +68,7 @@ Validate the default data type mappings and change them based on requirements, i
 1. On the **Tools** menu, select **Project Settings**.
 1. Select the **Type Mapping** tab.
 
-   ![Screenshot that shows Type Mapping.](./media/mysql-to-sql-server/type-mappings.png)
+   :::image type="content" source="./media/mysql-to-sql-server/type-mappings.png" alt-text="Screenshot that shows Type Mapping feature.":::
 
 1. You can change the type mapping for each table by selecting the table in **MySQL Metadata Explorer**.
 
@@ -85,24 +84,24 @@ To convert the schema:
 
 1. (Optional) To convert dynamic or ad-hoc queries, right-click the node and select **Add Statement**.
 1. Select the **Connect to SQL Server** tab.
-     1. Enter connection details for your SQL Server instance.
-     1. Select your target database from the drop-down list, or enter a new name, in which case a database will be created on the target server.
-     1. Enter authentication details, and then select **Connect**.
+   1. Enter connection details for your SQL Server instance.
+   1. Select your target database from the drop-down list, or enter a new name, in which case a database will be created on the target server.
+   1. Enter authentication details, and then select **Connect**.
 
-   ![Screenshot that shows Connect to SQL Server.](./media/mysql-to-sql-server/connect-to-sql-server.png)
+   :::image type="content" source="./media/mysql-to-sql-server/connect-to-sql-server.png" alt-text="Screenshot that shows Connect to SQL Server.":::
 
 1. Right-click the MySQL database in **MySQL Metadata Explorer**, and then select **Convert Schema**. Alternatively, you can select the **Convert Schema** tab in upper-right corner.
 
-   ![Screenshot that shows Convert Schema.](./media/mysql-to-sql-server/convert-schema.png)
+   :::image type="content" source="./media/mysql-to-sql-server/convert-schema.png" alt-text="Screenshot that shows Convert Schema option.":::
 
 1. After the conversion finishes, compare and review the converted objects to the original objects to identify potential problems and address them based on the recommendations.
 
-   ![Screenshot that shows comparing and reviewing objects.](./media/mysql-to-sql-server/table-comparison.png)
+   :::image type="content" source="./media/mysql-to-sql-server/table-comparison.png" alt-text="Screenshot that shows comparing and reviewing objects.":::
 
 1. Compare the converted Transact-SQL text to the original code, and review the recommendations.
 
-   ![Screenshot that shows comparing and reviewing converted code.](./media/mysql-to-sql-server/procedure-comparison.png)
-   
+   :::image type="content" source="./media/mysql-to-sql-server/procedure-comparison.png" alt-text="Screenshot that shows comparing and reviewing converted code.":::
+
 1. In the output pane, select **Review results** and review the errors in the **Error List** pane.
 1. Save the project locally for an offline schema remediation exercise. On the **File** menu, select **Save Project**. This step gives you an opportunity to evaluate the source and target schemas offline and perform remediation before you publish the schema to SQL Server.
 
@@ -115,16 +114,16 @@ After you have the necessary prerequisites in place and have completed the tasks
 You have two options for migrating data:
 
 - **Client-side data migration**
-	 -   To perform client-side data migration, select the **Client Side Data Migration Engine** option in the **Project Settings** dialog box.
+  - To perform client-side data migration, select the **Client Side Data Migration Engine** option in the **Project Settings** dialog box.
 
-    > [!NOTE]
-    > When SQL Express edition is used as the target database, only client-side data migration is allowed and server-side data migration isn't supported.
+  > [!NOTE]  
+  > When SQL Express edition is used as the target database, only client-side data migration is allowed and server-side data migration isn't supported.
 
 - **Server-side data migration**
-	-   Before you perform data migration on the server side, ensure that:
-	    - The SSMA for MySQL Extension Pack is installed on the instance of SQL Server.
-	    - The SQL Server Agent service is running on the instance of SQL Server.
-	-   To perform server-side data migration, select the **Server Side Data Migration Engine** option in the **Project Settings** dialog box.
+  - Before you perform data migration on the server side, ensure that:
+    - The SSMA for MySQL Extension Pack is installed on the instance of SQL Server.
+    - The SQL Server Agent service is running on the instance of SQL Server.
+  - To perform server-side data migration, select the **Server Side Data Migration Engine** option in the **Project Settings** dialog box.
 
 > [!IMPORTANT]  
 > If you plan to use the Server Side Data Migration Engine, before you migrate data, you must install the SSMA for MySQL Extension Pack and the MySQL providers on the computer that's running SSMA for MySQL. The SQL Server Agent service must also be running. For more information about how to install the extension pack, see [Installing SQL Server Migration Assistant Components on SQL Server (MySQL to SQL)](../../../ssma/mysql/installing-ssma-components-on-sql-server-mysqltosql.md).
@@ -133,23 +132,23 @@ To publish your schema and migrate the data:
 
 1. Publish the schema by right-clicking the database in **SQL Server Metadata Explorer** and selecting **Synchronize with Database**. This action publishes the MySQL database to the SQL Server instance.
 
-   ![Screenshot that shows Synchronize with Database.](./media/mysql-to-sql-server/synchronize-database.png)
+   :::image type="content" source="./media/mysql-to-sql-server/synchronize-database.png" alt-text="Screenshot that shows Synchronize with Database.":::
 
 1. Review the mapping between your source project and your target.
 
-   ![Screenshot that shows reviewing the synchronization with the database.](./media/mysql-to-sql-server/synchronize-database-review.png)
+   :::image type="content" source="./media/mysql-to-sql-server/synchronize-database-review.png" alt-text="Screenshot that shows reviewing the synchronization with the database.":::
 
 1. Migrate the data by right-clicking the database or object you want to migrate in **MySQL Metadata Explorer** and selecting **Migrate Data**. Alternatively, you can select the **Migrate Data** tab. To migrate data for an entire database, select the check box next to the database name. To migrate data from individual tables, expand the database, expand **Tables**, and then select the check boxes next to the tables. To omit data from individual tables, clear the check boxes.
 
-   ![Screenshot that shows Migrate Data.](./media/mysql-to-sql-server/migrate-data.png)
+   :::image type="content" source="./media/mysql-to-sql-server/migrate-data.png" alt-text="Screenshot that shows Migrate Data option.":::
 
 1. After migration is completed, view the **Data Migration Report**.
 
-   ![Screenshot that shows the Data Migration Report.](./media/mysql-to-sql-server/migration-report.png)
+   :::image type="content" source="./media/mysql-to-sql-server/migration-report.png" alt-text="Screenshot that shows the Data Migration Report.":::
 
 1. Connect to your SQL Server instance by using [SQL Server Management Studio](../../../ssms/download-sql-server-management-studio-ssms.md), and validate the migration by reviewing the data and schema.
 
-   ![Screenshot that shows validation in SQL Server Management Studio.](./media/mysql-to-sql-server/validate-in-ssms.png)
+   :::image type="content" source="./media/mysql-to-sql-server/validate-in-ssms.png" alt-text="Screenshot that shows validation in SQL Server Management Studio.":::
 
 ## Post-migration
 
@@ -172,23 +171,22 @@ The test approach for database migration consists of the following activities:
 
 The post-migration phase is crucial for reconciling any data accuracy issues, verifying completeness, and addressing performance issues with the workload.
 
-> [!Note]
+> [!NOTE]  
 > For more information about these issues and the steps to mitigate them, see the [Post-migration validation and optimization guide](../../../relational-databases/post-migration-validation-and-optimization-guide.md).
 
 ## Migration assets
 
 For more assistance with completing this migration scenario, see the following resource. It was developed in support of a real-world migration project engagement.
 
-| Title                    | Description            |
-| ----------------------------- | ---------------------- |
-| [Data Workload Assessment Model and Tool](https://www.microsoft.com/download/details.aspx?id=103130) | This tool provides suggested "best fit" target platforms, cloud readiness, and application or database remediation level for a given workload. It offers simple, one-click calculation and report generation that helps to accelerate large estate assessments by providing an automated and uniform target platform decision process.                |
-|[MySQL to SQL Server - Database Compare utility](https://www.microsoft.com/download/details.aspx?id=103016)|The Database Compare utility is a Windows console application that you can use to verify that the data is identical both on source and target platforms. You can use the tool to efficiently compare data down to the row or column level in all or selected tables, rows, and columns.|
+| Title | Description |
+| --- | --- |
+| [Data Workload Assessment Model and Tool](https://www.microsoft.com/download/details.aspx?id=103130) | This tool provides suggested "best fit" target platforms, cloud readiness, and application or database remediation level for a given workload. It offers easy calculation and report generation that helps to accelerate large estate assessments by providing an automated and uniform target platform decision process. |
+| [MySQL to SQL Server - Database Compare utility](https://www.microsoft.com/download/details.aspx?id=103016) | The Database Compare utility is a Windows console application that you can use to verify that the data is identical both on source and target platforms. You can use the tool to efficiently compare data down to the row or column level in all or selected tables, rows, and columns. |
 
 The Data SQL Engineering team developed these resources. This team's core charter is to unblock and accelerate complex modernization for data platform migration projects to Microsoft's Azure data platform.
 
-
 ## Next steps
 
-- To learn more about migrating MySQL databases to SQL Server, see [SQL Server Migration Assistant documentation for MySQL](../../../ssma/mysql/sql-server-migration-assistant-for-mysql-mysqltosql.md).
-- For a matrix of Microsoft and third-party services and tools that are available to assist you with various database and data migration scenarios and specialty tasks, see [Services and tools for data migration](/azure/dms/dms-tools-matrix).
-- For other migration guides, see [Azure Database Migration Guides](https://datamigration.microsoft.com/).
+- [SQL Server Migration Assistant documentation for MySQL](../../../ssma/mysql/sql-server-migration-assistant-for-mysql-mysqltosql.md)
+- [Services and tools for data migration](/azure/dms/dms-tools-matrix)
+- [Azure Database Migration Guides](https://datamigration.microsoft.com/)