使用 Database Migration Service 将数据库迁移到 AlloyDB for PostgreSQL

MySQL   |  PostgreSQL   |  PostgreSQL 到 AlloyDB

本快速入门将向您介绍如何使用 Database Migration Service 将数据迁移到 AlloyDB for PostgreSQL。如果您及时完成本快速入门中的步骤（包括清理），那么在此期间所创建资源的费用通常不会超过 1 美元。

准备工作

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the Database Migration Service API.

   Enable the API

7. 确保您已将 Database Migration Admin 角色分配给您的用户账号。

   转到 IAM 页面

要求

Database Migration Service 提供各种源数据库选项和连接方法。不同源使用某些连接方法的效果比使用其他方法更好。在本快速入门中，我们假设您在将网络配置为添加入站防火墙规则的环境中使用独立的 PostgreSQL 数据库。源数据库可以位于本地，也可以位于云提供商。由于我们无法获知您环境的具体细节，因此我们无法提供网络配置的详细步骤。

在本快速入门中，您将为源数据库引擎选择 PostgreSQL，为目标数据库引擎选择 AlloyDB for PostgreSQL，并将 VPC 对等互连作为网络方法。

创建源连接配置文件

创建连接配置文件后，您将创建包含来源数据库相关信息的记录。Database Migration Service 会使用连接配置文件中的信息将数据从源数据库迁移到目标 AlloyDB 数据库实例。

1. 前往 Google Cloud 控制台中的 Database Migration Service 连接配置文件页面。

   前往“数据库迁移服务连接配置文件”页面

2. 点击创建配置文件。

3. 在创建连接配置文件页面上，从配置文件角色列表中，选择来源。

4. 从数据库引擎列表中，选择来源数据库的以下分类类型之一：

   • 独立的 PostgreSQL 实例 (PostgreSQL)
   • 现有的 Cloud SQL for PostgreSQL 实例 (Cloud SQL for PostgreSQL)
   • Amazon RDS for PostgreSQL 实例

   在本快速入门中，选择 PostgreSQL。

4. 提供以下信息：
   • 在连接配置文件名称字段中，为源数据库的连接配置文件输入一个名称，例如 My Connection Profile。
   • 保留自动生成的连接配置文件 ID。
   • 输入网络连接信息：
     • 如果您要从自托管数据库进行复制，请输入用于访问主机的主机名或 IP 地址（域名或 IP）和端口。（默认的 PostgreSQL 端口为 5432。）
     • 如果您要从 Cloud SQL 数据库进行复制，请从下拉列表中选择 Cloud SQL 实例。
   • 输入用户名和密码，对源实例进行身份验证。

5. 在该页面的连接配置文件区域部分，选择您要在其中保存连接配置文件的区域。

   与所有资源一样，连接配置文件也保存在区域中。选择哪个区域不会影响哪些迁移作业可以使用这些连接配置文件，或哪些区域可以连接到数据位置本身，但在出现区域级停机时可能会影响可用性。

6. 点击创建。

创建迁移作业

Database Migration Service 会使用迁移作业将数据从源数据库实例迁移到目标 AlloyDB 数据库实例。

创建迁移作业包括以下步骤：

• 定义作业的设置
• 选择您为源数据库创建的连接配置文件（来源连接配置文件）
• 为目标 AlloyDB 数据库实例定义设置
• 在源数据库实例和目标数据库实例之间建立连接
• 测试迁移作业，以确保您为作业提供的连接信息有效

定义迁移作业的设置

1. 前往 Google Cloud 控制台中的 Database Migration Service“迁移作业”页面。

   前往 Database Migration Service 迁移作业页面

2. 点击创建迁移作业。

3. 在迁移作业名称字段中，为迁移作业输入名称，例如 My Migration Job。

4. 保留自动生成的迁移作业 ID。

5. 打开源数据库引擎下拉列表，然后选择源数据库的分类类型。在此快速入门中，选择 AlloyDB for PostgreSQL。

6. 选择要创建目标实例的目标区域。

7. 将迁移作业类型设为“持续”，因为您希望将源数据库中正在进行的更改迁移到目标 AlloyDB 数据库实例。

8. 查看自动生成的必要前提条件，以反映如何为迁移作业准备环境。这些前提条件可能包括如何配置源数据库，以及如何将其连接到目标 AlloyDB 数据库实例。最好在此步骤中完成这些前提条件，但您可以在测试迁移作业或启动迁移作业之前随时完成。如需详细了解这些前提条件，请参阅配置来源。

9. 点击保存并继续。

指定有关来源连接配置文件的信息

1. 打开选择来源连接配置文件下拉列表，然后选择您创建的连接配置文件。

2. 点击保存并继续。

创建目标 AlloyDB 集群

集群是 AlloyDB 中的顶级资源。如需创建目标集群，请执行以下操作：

1. 选择集群类型。Database Migration Service 目前支持高可用 AlloyDB 集群。它们可以从区域中的多个可用区传送数据，但没有读取池。
2. 点击继续。
3. 配置集群：
   1. 在集群 ID 字段中，输入集群的 ID。
   2. 在密码字段中，输入默认的 postgres 用户的密码。您需要输入密码才能登录数据库。
   3. 在网络字段中，选择一个网络路径，以便在设置迁移连接性时定义哪些资源可用。只能为集群配置专用 IP 网络路径。如果您计划通过 VPC 对等互连连接到源数据库，请选择源数据库所在的 VPC。
   4. （可选）选择分配的 IP 范围名称，用于指定您的实例可连接的 IP 地址。
   5. 点击继续。
4. 配置主实例。主实例决定集群的计算容量，并且支持读写操作：
1. 在实例 ID 字段中，输入主实例的 ID。
2. 选择机器类型。
3. 可选：为实例设置标志。您可以使用标志自定义实例。如需了解支持的标志，请参阅 AlloyDB 文档。对于每个标志：
   1. 点击添加标志。
   2. 从新数据库标志列表中选择一个标志。
   3. 为标志提供值。
   4. 点击完成。
5. 点击保存并继续。
6. 点击创建目标并继续确认您的选择。
7. 等待目标实例创建完成。

在 Database Migration Service 管理 AlloyDB 集群期间，该集群将处于“正在引导”状态。在“引导”阶段，您将无法对集群执行任何操作。如果您仍想删除集群，可以使用 gcloud 搭配 --force 选项执行此操作。

设置连接

1. 选择您要在源数据库和目标数据库之间建立连接时使用的网络方法。在本快速入门中，使用连接方法列表选择 VPC 对等互连作为网络方法。
2. 检查源数据库的 VPC 网络。点击配置并继续以完成连接配置文件配置。

配置迁移数据库

您可以选择要迁移的数据库。

1. 从要迁移的数据库列表中，选择所有数据库。

   系统会选择源数据库中存在的所有数据库进行迁移。

2. 点击保存并继续。

测试并创建迁移作业

1. 查看您为迁移作业选择的设置。

2. 点击测试作业，验证源实例是否已正确配置，源实例和目标实例是否能够相互通信，以及迁移作业是否有效。

3. 验证您是否看到“已成功通过测试！”状态。

   如果测试失败，您可以在流的适当部分解决问题，然后返回重新测试。

4. 点击创建并启动作业以创建迁移作业并立即启动。

5. 在随后显示的对话框中，点击开始。

6. 在迁移作业页面中，验证迁移作业的状态是否为“开始”。几分钟后，确认状态变为“正在运行”。

验证迁移作业

在本部分，您需要确认 Database Migration Service 使用迁移作业将数据从源数据库实例迁移到目标 AlloyDB 数据库实例。

1. 前往 Google Cloud 控制台中的 AlloyDB 集群页面。

   前往“AlloyDB 集群”页面

2. 点击迁移作业的读取副本条目。
3. 点击页面右上角显示的激活 Cloud Shell 图标。
4. 在 Cloud Shell 提示符中，按 Enter 键。
5. 可选：如果系统显示为 Cloud Shell 提供授权对话框，请点击授权。
6. 在输入密码提示符处，输入您在定义并创建目标 AlloyDB 实例中提供的密码或 Database Migration Service 为您生成的密码。

7. 在 postgres 提示符处，输入 \list 以列出数据库并验证您是否看到源数据库实例。
8. 在 postgres 提示符下，输入 \connect SOURCE_DB_NAME，因为您想查看与此数据库实例关联的表。提示的名称从 postgres 更改为 SOURCE_DB_NAME。
9. 在 SOURCE_DB_NAME 提示符处，输入 \dt 以查看此实例的表。
10. 在 SOURCE_DB_NAME 提示符处，输入 GRANT alloydbexternalsync to USER;，因为您要向此用户授予访问此实例表中数据的权限。

    将 USER 替换为您用于连接到目标数据库实例的用户的名称。

11. 在 SOURCE_DB_NAME 提示符处，输入 SELECT * from TABLE_NAME; 即可查看从源数据库实例中的表复制的信息。
12. 验证您是否在表中看到正确的信息。

这确认 Database Migration Service 已迁移数据。

提升迁移作业

您可以提升迁移作业了。因此，目标 AlloyDB 数据库实例会取代源数据库实例作为主要数据库。

1. 返回迁移作业页面。

2. 点击要提升的迁移作业。系统会显示迁移作业详情页面。

3. 等待复制延迟时间趋近于零。

4. 停止对源数据库的所有写入操作。

   您必须停止对源数据库的所有写入操作，因为通过提升迁移作业，目标 AlloyDB 数据库会成为主要数据库。

5. 等待复制延迟时间为零。

6. 点击要提升的迁移作业。此作业的状态应为“正在运行”。

7. 点击提升以提升迁移作业。

8. 在随后显示的对话框中，再次点击提升。

9. 验证迁移作业的状态是否为“正在促销”。几分钟后，确认状态变为“已完成”。

您的新 AlloyDB 数据库实例已可供使用。

清理

为避免因本页中使用的资源导致您的 Google Cloud 账号产生费用，请按照以下步骤操作。

1. 使用 Google Cloud 控制台删除您不需要的迁移作业、连接配置文件、AlloyDB 集群和项目。

后续步骤

• 详细了解如何管理连接配置文件。
• 详细了解迁移作业状态。
• 详细了解迁移作业指标。