教程：使用迁移服务从 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.azure.com 或将此区域的查询转发到 168.63.129.16（在 Azure 公共或私有 DNS 区域中解析 FQDN），则这可能包括 flexibleserver.example.com、198.1.0.2 或 PostgreSQL FQDN（如 flexibleserver.postgres.database.azure.com）之类的条目。
• 测试连接：启动目标与源之间的连接性测试。 连接成功后，请转到下一步，以确定目标与源之间的网络问题，并验证目标服务器的用户名和密码。 建立测试连接需要几分钟时间。

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

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

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

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

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

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

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

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

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

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

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

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

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

• 实例级别的验证：

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

• 数据库级别的验证：

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

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

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

如果同时出现“迁移”和“验证并迁移”，则完成在线迁移需要执行启动直接切换的额外步骤。 完成基础数据的复制和克隆后，迁移将进入“WaitingForUserAction”状态和“WaitingForCutoverTrigger”子状态。 在这种状态下，用户可以通过选择迁移从门户触发直接转换。

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

• 已停止写入源。
• latency 值减小为 0 或接近 0。

可以在迁移详细信息窗格中获取 latency 值：

latency 值表示目标上次与源同步的时间。 此时，可以停止写入源并启动直接转换。 如果源服务器上的流量很大，建议先停止写入，以便 latency 能够接近 0。 然后启动直接转换。

直接转换操作会将源中所有挂起的更改应用到目标，并完成迁移。 如果触发直接转换，则即使 latency 为非零值，复制也会在该时间点停止。 在目标上应用直接转换点之前源中的所有数据。 例如，如果直接转换点处的延迟为 15 分钟，则会对目标应用过去 15 分钟内的所有更改数据。 完成直接转换所需的时间取决于这 15 分钟内出现的更改积压工作。 因此，建议在触发直接转换之前，应确保延迟达到零或接近零。

进入“正在迁移数据”子状态或直接转换（在线迁移模式）成功完成后，迁移就会进入“已成功”状态。 如果“正在迁移数据”子状态出现问题，迁移将进入“已失败”状态。

本文介绍了如何使用 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 online --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

在在线迁移中完成基础数据迁移后，迁移任务会进入“WaitingForCutoverTrigger”子状态。 在此状态下，可以使用 Azure CLI 中的以下命令触发直接转换：

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

还可以通过选择迁移网格中的迁移名称在门户中触发直接转换。