使用迁移服务从 Google Cloud SQL for PostgreSQL 服务器联机迁移到 Azure Database for PostgreSQL

本文介绍如何使用 Azure 门户将 PostgreSQL 数据库从 Google Cloud SQL for PostgreSQL 服务器迁移到 Azure Database for PostgreSQL。 你可以使用 Azure 门户执行各种任务，包括数据库迁移。 可以按照本教程中所述的步骤将数据库无缝转移到 Azure，并利用其强大功能和可伸缩性。

该迁移服务在 Microsoft Azure 门户中提供了一种基于向导的简单体验。

使用 Azure 门户：

1. 选择您的“Azure Database for PostgreSQL”灵活服务器。

2. 在资源菜单中，选择 “迁移”。

   

3. 选择 “创建 ”以浏览基于向导的一系列选项卡，以便从本地或 Azure VM 迁移到灵活服务器。

   Nota

   第一次使用迁移服务时，将显示一个空网格，并提示你开始第一次迁移。

   如果已创建向灵活服务器目标的迁移，则该网格中当下会包含有关尝试的迁移的信息。

   

需要提供与迁移相关的多个详细信息，例如迁移名称、源服务器类型、选项和模式。

• 迁移名称 是每个迁移到此灵活服务器目标的唯一标识符。 此字段仅接受字母数字字符，不接受除连字符 (-) 之外的任何特殊字符。 名称不能以连字符开头，并且对于目标服务器应是唯一的。 向同一灵活服务器目标的两个迁移不能同名。

• 源服务器类型 - 根据 PostgreSQL 源，可以选择 Azure 虚拟机 或 本地服务器。

• 迁移选项 - 允许在触发迁移之前执行验证。 可以选择以下任一选项：

  • 验证 - 检查服务器和数据库准备情况，以便迁移到目标。
  • 验证和迁移 - 在触发迁移之前执行验证。 如果没有验证失败，则会启动迁移。

在运行迁移之前，选择 “验证 ”或“ 验证并迁移 ”选项始终是执行预迁移验证的好做法。

若要了解有关预迁移验证的详细信息，请访问预迁移。

• “迁移模式”允许选择迁移的模式。 脱机 是默认选项。 在这种情况下，我们将将其更改为 “联机”。

选择 “下一步：运行时服务器”。

迁移运行时服务器是 Azure Database for PostgreSQL 中的迁移服务中的专用功能，旨在充当迁移过程中的中介服务器。 它是一个单独的 Azure Database for PostgreSQL 灵活服务器实例，不是目标服务器，但用于促进从只能通过专用网络访问的源环境迁移数据库。

有关运行时服务器的详细信息，请访问 迁移运行时服务器。

“源服务器”选项卡会提示你提供与“设置”选项卡中选择的源（数据库源）相关的详细信息。

• 服务器名称 - 提供源 PostgreSQL 服务器的主机或 IP 地址的名称。
• 端口 - 源服务器的端口号。
• 管理员登录 名 - 源 PostgreSQL 服务器的管理员用户的名称。
• 密码 - 提供用于连接到源 PostgreSQL 服务器的管理员登录名的密码。
• SSL 模式 - 支持的值为 preferred 和 required。 当源 PostgreSQL 服务器的 SSL 是OFF时，请使用prefer。 如果源服务器上的 SSL 为 ON，则使用 require。 可以在源服务器的 postgresql.conf 文件中确定 SSL 值。
• 测试连接 - 执行目标与源之间的连接测试。 连接成功后，可以转到下一个选项卡。这些测试旨在识别目标服务器和源服务器之间可能存在的任何连接问题，包括使用提供的凭据验证身份验证。 建立测试连接需要几秒钟的时间。

成功测试连接后，选择“ 下一步：目标服务器”。

“目标服务器”选项卡显示灵活服务器目标的元数据，例如订阅名称、资源组、服务器名称、位置和 PostgreSQL 版本。

• 管理员登录 名 - 目标 PostgreSQL 服务器的管理员用户的名称。
• 密码 - 提供用于连接到目标 PostgreSQL 服务器的管理员登录名的密码。
• 自定义 FQDN 或 IP 地址：自定义 FQDN 或 IP 地址字段是可选的，可以在目标位于自定义 DNS 服务器后面或具有自定义 DNS 命名空间时使用，使其只能通过特定的 FQDN 或 IP 地址进行访问。 例如，可能包含像 production-flexible-server.example.com、198.1.0.2 或 PostgreSQL FQDN（如 production-flexible-server.postgres.database.chinacloudapi.cn）这样的条目，如果自定义 DNS 服务器包含 DNS 区域postgres.database.chinacloudapi.cn，或者将该区域的查询转发给168.63.129.16，其中 FQDN 在 Azure 公共或专用 DNS 区域中解析。
• 测试连接 - 在源和目标之间执行连接测试。 连接成功后，可以转到下一个选项卡。这些测试旨在识别源服务器和目标服务器之间可能存在的任何连接问题，包括使用提供的凭据验证身份验证。 建立测试连接需要几秒钟的时间。

成功测试连接后，选择“下一步：要验证或迁移的数据库”

在“ 要验证或迁移的数据库 ”选项卡下，可以选择要从源 PostgreSQL 服务器迁移的用户数据库列表。

选择数据库后，选择“ 下一步：摘要”。

“摘要”选项卡汇总了用于创建验证或迁移的所有源和目标详细信息。 查看详细信息，然后选择 “开始验证和迁移”。

可以取消任何正在进行的验证或迁移。 工作流必须处于 “正在进行 ”状态才能取消。 无法取消“ 成功 ”或 “失败 ”状态中的验证或迁移。

取消验证会停止任何进一步的验证活动，验证将变为 “已取消” 状态。

取消迁移会停止目标服务器上的进一步迁移活动，并移动到 “已取消” 状态。 此操作不会删除或回滚目标服务器上的任何更改。 请确保删除取消迁移所涉及的目标服务器上的数据库。

本文探讨如何使用 Azure CLI 将 PostgreSQL 数据库从 Azure 虚拟机或本地 PostgreSQL 实例迁移到 Azure Database for PostgreSQL。 Azure CLI 提供强大而灵活的命令行接口用于执行各种任务，包括数据库迁移。 可以按照本文中所述的步骤将数据库无缝转移到 Azure，并利用其强大功能和可伸缩性。

若要详细了解 Azure CLI 与迁移服务，请访问 如何为迁移服务设置 Azure CLI。

安装 CLI 后，打开命令提示符并使用以下命令登录到 Azure 帐户。

az login

若要开始迁移，请创建一个包含迁移详细信息的 JSON 文件。 该 JSON 文件包含以下信息：

• 在各 JSON 行中编辑以下占位符 << >>，并将它们以 <<filename>>.json 的形式存储在调用 CLI 的本地计算机中。 在本教程中，我们已将文件保存到 c:/migration-CLI/migration_body.json

{
"properties": {
"SourceDBServerResourceId": "<<source-server-hostname-or-IP-address>>:<<port>>@<<username>>",
        "SecretParameters": {
            "AdminCredentials": {
                "SourceServerPassword": "<<source-server-administrator-password>>",
                "TargetServerPassword": "<<target-server-administrator-password>>"
            },
            "targetServerUserName": "<<target-server-administrator-login>>"
        },
        "DBsToMigrate": "<<comma-separated-list-of-databases-in-array-like-["ticketdb","timedb","inventorydb"]>>",
        "OverwriteDBsInTarget": "true",
        "sourceType": "OnPremises",
        "sslMode": "Prefer"
    }
}

• 运行以下命令以检查是否有迁移正在运行。 迁移名称在 Azure Database for PostgreSQL 灵活服务器目标内的所有迁移中是唯一的。

  az postgres flexible-server migration list --subscription <subscription_id> --resource-group <resource_group> --name <target_server> --filter all
  

• 在上述步骤中，没有执行任何迁移，因此我们首先通过运行以下命令来启动新迁移。

  az postgres flexible-server migration create --subscription <subscription_id> --resource-group <resource_group> --name <target_server> --migration-name <migration> --migration-mode offline --migration-option ValidateAndMigrate --properties "c:/migration-cli/migration_body.json"
  

• 运行以下命令以查看在上一步中启动的迁移的状态。 你可以通过提供迁移名称来检查迁移的状态。

  az postgres flexible-server migration show --subscription <subscription_id> --resource-group <resource_group> --name <target_server> --migration-name <migration>
  

• 迁移的进度和状态显示在 Azure CLI 中。

• 还可以在 Azure 门户中查看进度和状态。

• 可以使用 cancel 命令取消任何正在进行的迁移尝试。 此命令会停止某次具体的迁移尝试，并回滚它在目标服务器上可能所做的所有更改。 下面是用于取消“正在进行”状态的迁移的 CLI 命令。

  az postgres flexible-server migration update cancel --subscription <subscription_id> --resource-group <resource_group> --name <target_server> --migration-name <migration>
  

对于验证和迁移选项，完成在线迁移需要用户完成一个附加步骤，即触发割接操作。 在基本数据复制或克隆完成后，迁移将移动到 Waiting for user action 状态和 Waiting for cutover trigger 子状态。 在此状态中，用户可以在门户中选择并触发迁移切换。

在启动直接转换之前，请务必确保：

• 已停止写入源 - latency 值为 0 或接近 0。 可以从迁移详细信息屏幕中获取 latency 信息，如下所示：
• latency 值减小为 0 或接近 0
• latency 值表示目标上次与源同步的时间。 此时，可以停止写入源并启动直接转换。 如果源中存在大量流量，建议先停止写入，以便 latency 可以接近 0，然后启动直接转换。

切换操作将所有挂起的更改从源服务器应用到目标服务器，并完成迁移。 如果您触发迁移切换，即便latency值为非零，复制将在该时间点停止。 直接转换点之前的所有源数据都将应用至目标。 如果在直接转换点遇到 15 分钟的延迟，则过去 15 分钟内对数据所做的所有更改将应用于目标。

所需时间取决于过去 15 分钟内发生的更改积压工作。 因此，建议在触发切换之前延迟为零或接近零。

• 当Migrating data的子状态或直接转换（在联机迁移中）成功完成时，迁移将进入Succeeded状态。 如果子状态出现问题 Migrating data ，迁移将进入 Failed 状态。

对于验证和迁移选项，完成在线迁移需要用户完成一个附加步骤，即触发割接操作。 在基本数据复制或克隆完成后，迁移将移动到 Waiting for user action 状态和 Waiting for cutover trigger 子状态。 在此状态下，用户可以使用以下命令通过 CLI 触发直接转换。 还可以通过选择迁移网格中的迁移名称从门户触发直接转换。

在启动直接转换之前，请务必确保：

• 已停止写入源 - latency 值为 0 或接近 0。 可以从迁移详细信息屏幕中获取 latency 信息，如下所示：
• latency 值减小为 0 或接近 0
• latency 值表示目标上次与源同步的时间。 此时，可以停止写入源并启动直接转换。 如果源中存在大量流量，建议先停止写入，以便 latency 可以接近 0，然后启动直接转换。

切换操作将所有挂起的更改从源服务器应用到目标服务器，并完成迁移。 如果您触发迁移切换，即便latency值为非零，复制将在该时间点停止。 直接转换点之前的所有源数据都将应用至目标。 如果在直接转换点遇到 15 分钟的延迟，则过去 15 分钟内对数据所做的所有更改将应用于目标。

所需时间取决于过去 15 分钟内发生的更改积压工作。 因此，建议在触发切换之前延迟为零或接近零。

• 当Migrating data的子状态或直接转换（在联机迁移中）成功完成时，迁移将进入Succeeded状态。 如果子状态出现问题 Migrating data ，迁移将进入 Failed 状态。

若要触发割接，请使用以下命令：

az postgres flexible-server migration update --subscription <subscription_id> --resource-group <resource_group> --name <server> --migration-name <migration> --cutover