使用 SSMA 项目(MySQLToSQL)

若要将 MySQL 数据库迁移到 SQL Server 或 Azure SQL,必须先创建 SQL Server 迁移助手(SSMA)项目。 项目是包含以下信息的文件:

  • 有关要迁移到 SQL Server 或 Azure SQL 的 MySQL 数据库的元数据。

  • 有关接收已迁移对象和数据的目标 SQL Server 或 Azure SQL 的目标实例的元数据。

  • SQL Server 或 Azure SQL 连接信息。

  • 项目设置。

打开项目时,它将与 MySQL 和 SQL Server 或 Azure SQL 断开连接。 这样,便可以脱机工作。 有关重新连接到 SQL Server 的详细信息,请参阅 “连接到 SQL Server”

查看默认项目设置

SSMA 包含用于转换和加载数据库、迁移数据以及将 SSMA 与 MySQL 和 SQL Server 或 Azure SQL 同步的多个设置。 默认设置适用于许多用户。 但是,在创建新的 SSMA 项目之前,应查看设置。 如有必要,可以更改所有新项目的默认设置。

  1. “工具”菜单中选择“默认项目设置”。

  2. “迁移目标版本” 下拉列表中选择要查看/更改设置的项目类型,然后选择“ 常规 ”选项卡。

  3. 在左窗格中,选择“ 转换”。

  4. 在右窗格中,根据需要查看和更改设置。 有关这些设置的详细信息,请参阅“项目设置”(转换)。

  5. 对迁移、同步、Azure SQL、GUI 和类型映射页重复步骤 1-3。

注释

只有在创建项目时选择 “迁移到 Azure SQL ”时,才会显示 Azure SQL 设置。

创建新项目

若要将数据从 MySQL 数据库迁移到 SQL Server 或 Azure SQL,必须创建一个项目。

  1. “文件”菜单中选择“新建项目”。 将显示“新建项目”对话框。 在“文件”菜单中,选择“新建项目”。 将显示“新建项目”对话框。

  2. 在“ 名称 ”框中,输入项目的名称。

  3. “位置” 框中,输入或选择项目的文件夹。

  4. “迁移到” 下拉列表中,选择用于迁移的目标 SQL Server 的版本。 可用的选项包括:

    • SQL Server 2016 (13.x)
    • SQL Server 2017 (14.x)
    • SQL Server 2019 (15.x)
    • SQL Server 2022 (16.x)
    • SQL Server 2025 (17.x)
    • Azure SQL 数据库
    • Azure SQL 托管实例

然后选择“ 确定”。

SSMA 创建项目文件。

自定义项目设置

除了定义适用于所有新 SSMA 项目的默认项目设置,还可以自定义每个项目的设置。 有关详细信息,请参阅 “设置项目选项”。

自定义源数据库和目标数据库之间的数据类型映射时,可以在项目、数据库或对象级别定义映射。 有关详细信息,请参阅 映射 MySQL 和 SQL Server 数据类型

保存项目

“保存项目”功能允许用户基本保存项目设置,还可以选择将数据库元数据保存到 SSMA 项目文件。

  1. 在“ 文件 ”菜单上,选择“ 保存 项目”。

    如果项目中的数据库已更改或尚未转换,SSMA 会提示加载和保存元数据。 加载和保存元数据使你可以脱机工作。 它还允许向其他人(如技术支持人员)发送完整的项目文件。 如果系统提示保存元数据,请执行以下作:

  2. 对于显示 缺少元数据状态的每个数据库,请选中数据库名称旁边的复选框。 保存元数据可能需要几分钟时间。 如果不想此时保存元数据,请不要选中任何复选框。

  3. 选择“保存”

SSMA 分析 MySQL 架构并将元数据保存到项目文件。

打开项目

打开项目时,它已从 MySQL 和 SQL Server 或 Azure SQL 断开连接。 这使你可以脱机工作。 若要更新元数据,请将数据库对象加载到 SQL Server 或 Azure SQL 中。 若要迁移数据,必须重新连接到 SQL Server 或 Azure SQL。

  1. 使用下列过程之一:

    1. 在“ 文件 ”菜单上,指向 “最近使用的项目”。

    2. 选择要打开的项目。

    3. 在“ 文件 ”菜单上,选择 “打开项目”,找到 .m2ssproj 项目文件,选择该文件,然后选择“ 打开”。

  2. 若要重新连接到 MySQL,请在 “文件 ”菜单上,选择“ 重新连接到 MySQL”。

  3. 若要重新连接到 SQL Server,请在“ 文件 ”菜单上选择“ 重新连接到 SQL Server”。

  4. 若要重新连接到 Azure SQL,请在“ 文件 ”菜单上,选择“ 重新连接到 Azure SQL”。