将本地 MySQL 迁移到 Azure Database for MySQL：使用 MySQL Workbench 完成数据迁移

数据迁移对于将 MySQL 数据库从本地环境迁移到 Azure Database for MySQL 极其重要。 本文旨在重点介绍如何使用 MySQL Workbench 这一简化迁移的强大工具。 若使用 MySQL Workbench，即可高效地传输数据，同时最大程度减少停机时间，确保数据完整性。 本指南旨在介绍使用 MySQL Workbench 设置和执行数据迁移的分步过程，重点说明了最佳做法和要避免的潜在陷阱。 无论是经验丰富的数据库管理员还是数据库迁移新手，本文都会提供无缝且成功迁移到 Azure 所需的见解和技术。

先决条件

将本地 MySQL 迁移到 Azure Database for MySQL：数据迁移

安装

按照安装指南中的所有步骤创建环境，以支持以下步骤。

配置服务器参数（源）

根据选择的迁移类型（脱机和联机），需要评估是否要修改服务器参数以支持快速传出数据。 如果联机迁移，可能无需对服务器参数执行任何操作，因为系统可能会执行 binlog 复制并自行同步数据。 但是，如果脱机迁移，则在停止应用程序流量后，可以将服务器参数从支持工作负荷中切换为支持导出。

配置服务器参数（目标）

在开始向 Azure Database for MySQL 导入进程之前，请查看服务器参数。 可使用 Azure 门户检索和设置服务器参数，或者通过调用 Azure PowerShell for MySQL cmdlet 进行更改。

执行以下 PowerShell 脚本以获取所有参数：

\[Net.ServicePointManager\]::SecurityProtocol = \[Net.SecurityProtocolType\]::Tls
12

Install-Module -Name Az.MySql
Connect-AzAccount -Environment AzureChinaCloud
$rgName = "{RESOURCE\_GROUP\_NAME}";
$serverName = "{SERVER\_NAME}";
Get-AzMySqlConfiguration -ResourceGroupName $rgName -ServerName $serverName

• 若要使用 mysql 工具执行相同操作，请将 CA 根证书下载到 c:\temp（创建此目录）。

  注意

  此证书可能会更改。 有关证书的最新信息，请参阅配置应用程序中的 SSL 连接性以安全连接到 Azure Database for MySQL。

• 在命令提示符下运行以下命令，确保更新令牌：

mysql --host {servername}.mysql.database.chinacloudapi.cn --database mysql --user
{u sername}@{servername} -p --ssl-ca=c:\\temp\\DigiCertGlobalRootCA.crt.pem
-A -e "SHOW GLOBAL VARIABLES;" \> c:\\temp\\settings\_azure.txt

在新的 `settings_azure.txt` 文件中，可以看到默认的 Azure Database for MySQL 服务器参数，如附录中所示。

若要支持迁移，请设置目标 MySQL 实例参数以允许更快传入。 在开始数据迁移之前，应设置下列服务器参数：

• max\_allowed\_packet – 将参数设置为 1073741824（即 1 GB）或数据库中某行的最大大小，以避免因长行导致溢出问题。 如果有需要拉取（或读取）的大型 BLOB 行，请考虑调整此参数。

• innodb\_buffer\_pool\_size – 在迁移期间从门户的定价层纵向扩展服务器到 32 vCore 内存优化 SKU，以增大 innodb_buffer_pool_size。 只能通过纵向扩展 Azure Database for MySQL 服务器的计算来增大 innodb_buffer_pool_size。 参阅 Azure Database for MySQL 中的服务器参数，以了解该层的最大值。 内存优化 32 vCore 系统中的最大值为 132070244352。

• innodb\_io\_capacity&innodb\_io\_capacity\_max - 将该参数更改为 9000 以提高 IO 利用率，从而优化迁移速度。

• max\_connections - 如果使用生成多个线程的工具来提高吞吐量，请增加连接以支持该工具。 默认值为 151，最大值为 5000。

  注意

  执行缩放时请小心。 某些操作不能撤消，如存储缩放。

可以使用以下 Azure PowerShell cmdlet 更新这些设置：

Install-Module -Name Az.MySql
$rgName = " {RESOURCE\_GROUP\_NAME}";
$serverName = "{SERVER\_NAME}";

Select-AzSubscription -Subscription "{SUBSCRIPTION\_ID}"
Update-AzMySqlConfiguration -Name max\_allowed\_packet -ResourceGroupName
$rgna me -ServerName $serverName -Value 1073741824
Update-AzMySqlConfiguration -Name innodb\_buffer\_pool\_size -ResourceGroupName
$rgname -ServerName $serverName -Value 16106127360
Update-AzMySqlConfiguration -Name innodb\_io\_capacity -ResourceGroupName
$rgna me -ServerName $serverName -Value 9000
Update-AzMySqlConfiguration -Name innodb\_io\_capacity\_max -ResourceGroupName
$ rgname -ServerName $serverName -Value 9000

\#required if You've functions

Update-AzMySqlConfiguration -Name log\_bin\_trust\_function\_creators
-ResourceGr oupName $rgname -ServerName $serverName -Value ON

数据

工具选择

迁移源系统中的数据库对象和用户后，就可以开始迁移。 MySQL 版本 8.0 上运行的数据库无法使用 Azure DMS 来迁移工作负荷。 相反，迁移用户应该使用 MySQL 工作台。

手动导入和导出步骤

• 打开 MySQL Workbench 并连接为本地数据库的根用户。

• 在“管理”下，选择“数据导出”********。 选择 reg_app 架构。

• 在“导出对象”中，选择“转储存储过程和函数”、“转储事件”和“转储触发器”。

• 在“导出选项”下，选择“导出到独立文件”。

• 同时，选中“包括创建架构”复选框。 请参阅下图以查看正确的 mysqldump 配置。

  

  Test

• 如果这些选项中的任何一个不可用，它们可能是受到“输出”窗格的阻碍。 只需更改编辑器布局即可。

  

  Test

• 选择“导出进度”选项卡。

• 选择“开始导出”，并注意 MySQL Workbench 会调用 mysqldump 工具。

• 打开新创建的导出脚本。

• 查找所有 DEFINER 语句，并将其更改为有效用户或完全删除。

• 查找 SET GLOBAL 语句，并将其更改为有效用户或完全删除。

• 确保未将 sql\_mode 设置为 NO\_AUTO\_CREATE\_USER。

• 删除 hello\_world 函数。

• 在 MySQL Workbench 中，创建与 Azure Database for MySQL 的新连接。

  • 对于“主机名”，输入完整服务器 DNS（例如：servername.mysql.database.chinacloudapi.cn）。

  • 输入用户名（例如：sqlroot@servername）。

  • 选择“SSL”选项卡。

  • 对于 SSL CA 文件，请浏览到 DigiCertGlobalRootCA.crt.pem 密钥文件。

  • 选择“测试连接”，确保完成连接。

  • 选择“确定”。

    

    “MySQL 连接”对话框如上所示。

• 选择“文件 -> 打开 SQL 脚本”。

• 浏览找到转储文件，然后选择“打开”。

• 选择“执行”。

更新应用程序以支持 SSL

• 使用 Visual Studio Code 切换到 Java 服务器 API。

• 打开“launch.json”文件。

• 将 DB_CONNECTION_URL 更新为 jdbc:mysql://serverDNSname:3306/reg\_app?useUnicode=true\&useJDBCCompliantT imezoneShift=true\&useLegacyDatetimeCode=false\&serverTimezone=UTC\&verifySe rverCertificate=true\&useSSL=true\&requireSSL=true\&noAccessToProcedureBodie s=true.。注意其他 SSL 参数。

• 将 DB_USER_NAME 更新为 conferenceuser@servername。

• 启动“调试”配置，并确保应用程序使用新数据库在本地运行。

修改服务器参数

可以更改 Azure Database for MySQL 目标实例上的以下参数。 可以通过 Azure 门户或使用 Azure PowerShell for MySQL cmdlet 来设置这些参数。

$rgName = "YourRGName";
$serverName = "servername";
Update-AzMySqlConfiguration -Name max\_allowed\_packet -ResourceGroupName
$rgna me -ServerName $serverName -Value 536870912
Update-AzMySqlConfiguration -Name innodb\_buffer\_pool\_size -ResourceGroupName
$rgname -ServerName $serverName -Value 16106127360
Update-AzMySqlConfiguration -Name innodb\_io\_capacity -ResourceGroupName $rgna
me -ServerName $serverName -Value 200
Update-AzMySqlConfiguration -Name innodb\_io\_capacity\_max -ResourceGroupName
$ rgname -ServerName $serverName -Value 2000

更改 Java API 的连接字符串

• 使用以下命令更改应用服务 Java API 的连接字符串

$rgName = "YourRGName";
$app_name = "servername";
az webapp config appsettings set -g $rgName -n $app_name
--settings DB_CONNECTION_URL={DB_CONNECTION_URL}

• 重启应用服务 API

az webapp restart -g $rgName -n $app\_name

已成功完成本地 Azure Database for MySQL 迁移！

下一步