使用 Azure Database for MySQL 导入 CLI 将 MySQL 本地或虚拟机 (VM) 工作负载迁移到 Azure Database for MySQL 灵活服务器

借助用于外部迁移的 Azure Database for MySQL 导入，可以将 MySQL 本地或虚拟机 (VM) 工作负载无缝迁移到 Azure Database for MySQL 灵活服务器。 它使用用户提供的物理备份文件，将源服务器的物理数据文件还原到目标服务器，提供简单、快速的迁移路径。 在执行导入操作之后，可以利用灵活服务器的优势，包括更好的性价比、对数据库配置的精细控制以及自定义维护时段。

根据用户输入，它负责预配目标灵活服务器，然后将存储在 Azure Blob 存储帐户中的用户提供的源服务器物理备份还原到目标灵活服务器实例。

本教程介绍如何使用 Azure Database for MySQL 导入 CLI 命令将 MySQL 本地或虚拟机 (VM) 工作负载迁移到 Azure Database for MySQL 灵活服务器。

本教程需要 Azure CLI 2.54.0 或更高版本。 要查找版本，请运行 az --version。 如果需要进行安装或升级，请参阅安装 Azure CLI。

安装

必须使用 az sign-in 命令登录帐户。 请注意 ID 属性，该属性指的是 Azure 帐户的订阅 ID。

az login

使用 az account set 命令在你的帐户下选择要在其中部署目标灵活服务器的特定订阅。 请注意将 az login 输出中的 ID 值用作命令中 subscription 参数的值。 若要获取所有订阅，请使用 az account list。

az account set --subscription <subscription id>

先决条件

• 源服务器应具有以下参数：

  • Lower_case_table_names = 1
  • Innodb_file_per_table = ON
  • 系统表空间名称应为 ibdata1。
  • 系统表空间大小应大于或等于 12 MB。 （MySQL 默认值）
  • Innodb_page_size = 16348（MySQL 默认值）
  • 仅支持 INNODB 引擎。

• 使用 Percona XtraBackup 对 MySQL 工作负荷进行物理备份。 以下是使用 Percona XtraBackup 执行完整备份的步骤：

  • 在本地或 VM 工作负载上安装 Percona XtraBackup。 对于 MySQL 引擎版本 v5.7，请安装 Percona XtraBackup 版本 2.4（参阅安装 Percona XtraBackup 2.4）。 对于 MySQL 引擎版本 v8.0，请安装 Percona XtraBackup 版本 8.0（参阅安装 Percona XtraBackup 8.0）。

  • 有关使用 Percona XtraBackup 2.4 执行完整备份的说明，请参阅完整备份。 有关使用 Percona XtraBackup 8.0 执行完整备份的说明，请参阅[完整备份] (https://docs.percona.com/percona-xtrabackup/8.0/create-full-backup.html)。 执行完整备份时，请按顺序运行以下命令：

    • - xtrabackup --backup --host={host} --user={user} --password={password} --target-dir={backup__dir_path}
    • - xtrabackup --prepare --{backup_dir_path}（在此处提供与之前命令中相同的备份路径）

  • 获取 Percona XtraBackup 时的注意事项：

    • 请确保运行备份和准备步骤。
    • 请确保备份和准备步骤中没有错误。
    • 请保留 Azure 支持所需的备份和准备步骤日志，发生故障时需要它。

    重要

    尝试访问从源服务器导入的已损坏的表可能会导致灵活服务器故障。 因此，在使用 Percona XtraBackup 实用工具进行备份之前，强烈建议在源服务器上执行“mysqlcheck / 优化表”操作。

• 创建 Azure Blob 容器并获取容器的共享访问签名 (SAS) 令牌（Azure 门户或 Azure CLI）。 确保在“权限”下拉列表中授予“添加”、“创建”和“写入”权限。 请将 Blob SAS 令牌和 URL 值复制并粘贴到安全的位置。 这些信息只会显示一次，窗口关闭后就无法检索。

• 将 {backup_dir_path} 上的完整备份文件上传到 Azure Blob 存储。 按照这些步骤上传文件。

• 若要执行联机迁移，请通过运行 cat xtrabackup_info 命令并复制 bin_log pos 输出来捕获和存储使用 Percona XtraBackup 获取的备份文件的 bin-log 位置。

• 应该可以使用 SAS 令牌公开访问 Azure 存储帐户。 不支持具有虚拟网络配置的 Azure 存储帐户。

限制

• 未迁移源服务器配置。 必须对目标灵活服务器进行适当配置。
• 不支持迁移加密备份。
• 用户和权限不会作为 Azure Database for MySQL 导入的一部分进行迁移。 在启动 Azure Database for MySQL 导入之前，必须先手动转储用户和权限，以便在执行导入操作后通过在目标灵活服务器上还原登录信息来对其进行迁移。
  • 无法迁移 user1@localhost，因为我们不支持在灵活服务器中创建 localhost 用户。
• 启用高可用性 (HA) 的灵活服务器作为禁用 HA 的服务器返回，以提高导入迁移后迁移操作的速度。 在迁移后为目标灵活服务器启用 HA。

实现最佳迁移体验的建议

• 请考虑将 Azure Blob 存储帐户和要部署的目标灵活服务器保留在同一区域中，以提高导入性能。
• 目标 Azure Database for MySQL 灵活服务器的建议 SKU 配置
  • 建议不要为目标设置可突发 SKU，以便在运行 Azure Database for MySQL 导入操作时优化迁移时间。 建议在导入操作、后期过程中缩放到“常规用途”/“业务关键”（可以将其纵向缩减为可突发 SKU）。

触发 Azure Database for MySQL 导入操作，以便从 Azure Database for MySQL 灵活服务器迁移

使用 az mysql flexible-server import create 命令触发 Azure Database for MySQL 导入操作。 以下命令会创建一个目标灵活服务器，并使用 Azure CLI 本地上下文执行从备份文件到目标的实例级导入：

az mysql flexible-server import create --data-source-type
                                --data-source
                                --data-source-sas-token
                                --resource-group
                                --name
                                --sku-name
                                --tier
                                --version
                                --location
                                [--data-source-backup-dir]
                                [--storage-size]
                                [--mode]
                                [--admin-password]
                                [--admin-user]
                                [--auto-scale-iops {Disabled, Enabled}]
                                [--backup-identity]
                                [--backup-key]
                                [--backup-retention]
                                [--database-name]
                                [--geo-redundant-backup {Disabled, Enabled}]
                                [--high-availability {Disabled, SameZone, ZoneRedundant}]
                                [--identity]
                                [--iops]
                                [--key]
                                [--private-dns-zone]
                                [--public-access]
                                [--resource-group]
                                [--standby-zone]
                                [--storage-auto-grow {Disabled, Enabled}]
                                [--subnet]
                                [--subnet-prefixes]
                                [--tags]
                                [--vnet]
                                [--zone]

The following example takes in the data source information for your source MySQL server's backup file and target Flexible Server information, creates a target Flexible Server named `test-flexible-server` in the `chinanorth3` location and performs an import from backup file to target.

azurecli
az mysql flexible-server import create --data-source-type "azure_blob" --data-source "https://onprembackup.blob.core.chinacloudapi.cn/onprembackup" --data-source-backup-dir "mysql_backup_percona" –-data-source-token "{sas-token}" --resource-group "test-rg"  --name "test-flexible-server" –-sku-name Standard_D2ds_v4  --tier GeneralPurpose –-version 5.7 -–location "chinanorth2"

下面是上述参数的详细信息：

以最短的停机时间迁移到灵活服务器

要在使用 Azure Database for MySQL 导入从备份文件完成初始种子设定后执行联机迁移，可以按照此处的步骤配置源和目标之间的数据传入复制。 可以使用在使用 Percona XtraBackup 获取备份文件时捕获的 bin-log 位置来设置基于 Bin-log 位置的复制。

Azure Database for MySQL 导入迁移 MySQL 实例需要多长时间？

基于存储大小的基准性能。

随着存储大小的增加，数据复制所需的时间也会增加，几乎呈线性相关。 然而，需要注意的是，网络波动会对复制速度产生显著影响。 因此，此处提供的数据应仅作为参考。

下一步