教程：使用迁移服务从 Amazon Aurora PostgreSQL 离线迁移到 Azure Database for PostgreSQL

Azure 门户提供简单直观的基于向导的体验，可引导你完成迁移。 完成本教程中所述的步骤，可以将数据库无缝转移到 Azure Database for PostgreSQL 灵活服务器，并利用其强大的功能和可伸缩性。

若要使用 Azure 门户进行迁移，请先配置迁移任务。 然后连接到源和目标并启动迁移。

配置迁移任务

若要在 Azure 门户中配置迁移任务，请执行以下操作：

1. 打开 Web 浏览器，并转到 Azure 门户。 输入凭据登录。

2. 转到你的 Azure Database for PostgreSQL 灵活服务器实例。

3. 在服务菜单中，选择“迁移”。

   

4. 选择“创建”，从 Amazon Aurora 迁移到灵活服务器。

   第一次使用迁移服务时，将显示一个空网格，并提示你开始第一次迁移。 如果已创建向灵活服务器目标的迁移，则该网格中会包含有关尝试的迁移的信息。

5. 选择“创建”，通过一系列选项卡逐步设置迁移。

   

安装

输入或选择以下信息：

• 迁移名称：输入每个到此灵活服务器目标的迁移的唯一标识符。 迁移名称中只能使用字母数字字符和连字符 (-)。 名称不能以连字符开头，它对于目标服务器来说必须是独一无二的。 到同一灵活服务器目标的两个迁移不能同名。

• 源服务器类型：选择与 PostgreSQL 源相对应的源类型，例如基于云的 PostgreSQL 服务、本地设置或虚拟机。

• 迁移选项：选择以下选项之一进行预迁移验证：

  • 验证。 检查服务器和数据库就绪情况，以便迁移到目标源。
  • 迁移。 跳过验证并开始迁移。
  • 验证并迁移。 在触发迁移之前执行验证。 仅当未发生验证失败时，才会触发迁移。

  一个好的做法是选择“验证”或“验证并迁移”选项进行预迁移验证。

  有关详细信息，请参阅预迁移验证。

• 迁移模式：选择迁移的模式。 默认选项为“脱机”。

选择“下一步: 连接到源”。

选择运行时服务器

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

有关详细信息，请参阅迁移运行时服务器。

连接到源

在“连接到源”选项卡上，输入或选择数据库源的以下信息：

• 服务器名称 - 输入源 PostgreSQL 实例的主机名或 IP 地址。
• 端口：输入源服务器的端口号。
• 服务器管理员登录名：输入源 PostgreSQL 服务器的用户名。
• 密码：输入源 PostgreSQL 服务器的密码。
• SSL 模式：支持的值为“Prefer”和“Require”。 当源 PostgreSQL 服务器上的安全套接字层 (SSL) 处于关闭状态时，请选择“Prefer”。 如果源服务器上的 SSL 处于启用状态，请选择“Require”。 SSL 值在 postgresql.conf 文件中设置。
• 测试连接：启动目标与源之间的连接性测试。 连接成功后，请转到下一步，以确定目标与源之间的网络问题，并验证源的用户名和密码。 建立测试连接需要几分钟时间。

测试连接成功后，选择“下一步: 选择迁移目标”。

选择迁移目标

在“选择迁移目标”选项卡上，除了订阅、资源组和服务器名称之外，还请输入或选择灵活服务器目标的以下信息：

• 管理员用户名：目标 PostgreSQL 服务器的管理员用户名。
• 密码：目标 PostgreSQL 服务器的密码。
• 自定义 FQDN/IP（可选）：自定义 FQDN/IP 字段是可选的，可在目标位于自定义 DNS 服务器后面或具有自定义 DNS 命名空间时使用，这使得它只能通过特定的 FQDN 或 IP 地址进行访问。 例如，如果自定义 DNS 服务器包含 DNS 区域 postgres.database.chinacloudapi.cn 或将此区域的查询转发到 168.63.129.16（在 Azure 公共或私有 DNS 区域中解析 FQDN），则这可能包括 flexibleserver.example.com、198.1.0.2 或 PostgreSQL FQDN（如 flexibleserver.postgres.database.chinacloudapi.cn）之类的条目。
• 测试连接：启动目标与源之间的连接性测试。 连接成功后，请转到下一步，以确定目标与源之间的网络问题，并验证目标服务器的用户名和密码。 建立测试连接需要几分钟时间。

测试连接成功后，选择“下一步: 选择要迁移的数据库”。

选择要迁移的数据库

在“选择要迁移的数据库”选项卡上，请从要从源 PostgreSQL 服务器迁移的一系列用户数据库中进行选择。

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

总结

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

监视迁移

选择“开始验证和迁移”后，几秒钟内会显示一条通知，指出验证或迁移创建成功。 系统会将你重定向到灵活服务器实例的“迁移”窗格。 状态条目为 InProgress，子状态为 PerformingPreRequisiteSteps。 该工作流需要 2 到 3 分钟来设置迁移基础结构和检查网络连接。

显示迁移的网格包含以下列：

• Name
• Status
• 迁移模式
• 迁移类型
• 源服务器
• 源服务器类型
• 数据库
• Duration
• 开始时间

条目按开始时间降序显示，最新条目位于顶部。 可以选择菜单栏中的“刷新”来刷新验证或迁移运行的状态。

迁移详细信息

在迁移列表中，选择迁移的名称以查看关联的详细信息。

在“设置”选项卡中，选择迁移选项“验证并迁移”。 在这种情况下，将先完成验证，然后再开始迁移。 完成“PerformingPreRequisiteSteps”子状态后，工作流将进入“正在进行验证”子状态。

• 如果验证出现错误，迁移将进入“失败”状态。

• 如果验证完成且未出现任何错误，迁移会开始，并且工作流将进入“正在迁移数据”子状态。

可以在实例级别和数据库级别对验证详细信息进行检查：

• 实例级别的验证：

  • 检查与源版本的连接性检查（PostgreSQL version >= 9.5 服务器参数检查）相关的验证，即是否在 Azure Database for PostgreSQL 灵活服务器实例的服务器参数中启用了扩展。

• 数据库级别的验证：

  • 检查与 Azure Database for PostgreSQL 灵活服务器中的扩展和排序规则支持相关的对单个数据库的验证。

可以在迁移详细信息窗格中查看迁移和验证的当前状态。

下表描述了某些可能的迁移状态和子状态。

迁移状态

迁移子状态

验证子状态

取消迁移

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

取消迁移会停止目标服务器上的进一步迁移活动，并将迁移尝试移动到“已取消”状态。 取消操作会回滚迁移服务在目标服务器上所做的所有更改。

本文介绍了如何使用 Azure CLI 将 PostgreSQL 数据库从 Amazon Aurora 迁移到 Azure Database for PostgreSQL。 Azure CLI 是一个强大而灵活的命令行界面，可以用来完成各种任务（包括数据库迁移）。

有关详细信息，请参阅为迁移服务设置 Azure CLI。

安装 Azure CLI 后，请在命令行中使用以下命令登录到 Azure 帐户：

az login

配置迁移任务

1. 若要开始迁移，请创建一个用于保存迁移详细信息的 JSON 文件。 将 JSON 文件以 [filename].json 形式保存在本地计算机上。 例如，可以将文件保存为 C:\migration-CLI\migration_body.json。

   复制以下 JSON 并将其粘贴到该 JSON 文件中。 用你的场景中的相关信息替换 <placeholders>。

   {
   "properties": {
   "SourceDBServerResourceId": "<source host name or IP address>:<port>@<username>",
           "SecretParameters": {
               "AdminCredentials": {
                   "SourceServerPassword": "<source password>",
                   "TargetServerPassword": "<target password>"
               },
               "targetServerUserName": "<target username>"
           },
           "DBsToMigrate": "<a comma-separated list of databases in an array, similar to the example "ticketdb","timedb","inventorydb">",
           "OverwriteDBsInTarget": "true",
           "sourceType": "AWS_AURORA",
           "sslMode": "Require"
       }
   }
   

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

   az postgres flexible-server migration list --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --filter All
   

3. 在前述步骤中，没有执行迁移，因此我们首先运行以下命令来启动新迁移

   az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --migration-mode offline --migration-option ValidateAndMigrate --properties "C:\migration-cli\migration_body.json"
   

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

   az postgres flexible-server migration show --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
   

   迁移进度的状态会显示在 Azure CLI 中。 还可以在 Azure 门户中查看 Azure Database for PostgreSQL 灵活服务器实例的状态。

取消或删除迁移

可以使用 cancel 命令取消任何正在进行的迁移尝试。 此命令会停止特定的迁移尝试并回滚目标服务器上的所有更改。

下面是用于删除迁移的 Azure CLI 命令：

az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1