Microsoft SQL Server Migration Assistant for MySQL

SQL Server Migration Assistant (SSMA) is a free supported tool from Microsoft that simplifies database migration process from MySQL to SQL Server. Azure SQL Database and Azure SQL Database Managed Instance. SSMA automates all aspects of migration including migration assessment analysis, schema and SQL statement conversion, data migration as well as migration testing.

This download includes a GUI client based application to manage migration process. A seperate extension pack will install functionalities in SQL Server to emulate MySQL features not natively supported in SQL Server.

SSMA for MySQL is designed to support migration from MySQL 4.1 and higher to all editions of SQL Server 2012 through SQL Server 2022, Azure SQL Database and Azure SQL Database Managed Instance.

Supported Operating Systems

Windows Server 2016, Windows 10, Windows Server 2012 R2, Windows Server 2008 R2, Windows Server 2012, Windows 7, Windows 8, Windows 8.1

• Windows 7, Windows 8, Windows 8.1, Windows 10, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server 2016

Requirements for the SSMA for MySQL client:

• Microsoft Windows Installer 3.1 or a later version.
• The Microsoft .NET Framework version 4.7.2 or a later version. You can obtain it from the .NET Framework Developer Center.
• Access to and sufficient permissions on the computer that hosts the target instance of SQL Server.
• MySQL Connector/ODBC v5.1.
• 4 GB RAM.

After the download, you must extract the installation files before you can install SSMA for MySQL.

Installing the SSMA for MySQL Client

1. Double-click SSMAforMySQL_n.msi, where n is the version number.
2. On the 'Welcome' page, click Next.
3. If you do not have the prerequisites installed, a message will appear that indicates that you must first install required components. Make sure that you have installed all prerequisites, and then run the installation program again.
4. Read the End User License Agreement. If you agree to the terms, select "I accept the agreement" option and click Next.
5. On the 'Choose Setup Type' page, click Typical.
6. Click Install.

In addition to the SSMA program files, you must also install the SSMA for MySQL Extension Pack on the SQL Server machine.

Installing the SSMA for MySQL Extension Pack
Installing the extension pack creates a new database, sysdb, on the instance of SQL Server. The extension pack adds tables, stored procedures, and user-defined functions.

1. Double-click SSMAforMySQLExtensionPack_n.msi file, where n is the version number.
2. On the 'Welcome' page, click Next.
3. Read the End User License Agreement. If you agree to the terms, select "I accept the agreement" option and click Next.
4. On the 'Choose Setup Type' page, click Typical.
5. On the 'Ready to Install' page, click Install.
6. On the 'Completed the First Step of Installation' page, click Next. A new dialog box will appear, in which you select the instance of SQL Server for the extension pack installation.
7. Select the instance of SQL Server where you will be migrating MySQL schemas, and then click Next. The default instance has the same name as the computer. Named instances will be followed by a backslash and the instance name.
8. On the connection page, select the authentication method and then click Next. Windows Authentication will use your Windows credentials to try to log on to the instance of SQL Server. If you select SQL Server Authentication, you must enter a SQL Server login name and password.
9. On the next page, select Install Utilities Database n, where n is the version number, and then click Next. The sysdb database is created and the user-defined functions and stored procedures are created in that database.
10. To install the utilities to another instance of SQL Server, select Yes, and then click Next. Or, to exit the wizard, click No.

NOTE: Extension pack and its functionality is not supported for SQL Server on Linux, Azure SQL Database and Azure SQL Database Managed Instance.