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

MySQL   |  PostgreSQL   |  PostgreSQL 到 AlloyDB

此快速入门指南将向您展示如何使用 Database Migration Service 将数据迁移到 Cloud SQL for PostgreSQL。如果您及时完成本快速入门中的步骤（包括清理），那么在此期间所创建资源的费用通常不会超过 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.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

1. Enable the Database Migration Service API.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the API

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

   转到 IAM 页面

要求

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

在此快速入门中，您将选择 PostgreSQL 作为源数据库引擎，并选择 IP 许可名单作为网络方法。

创建源连接配置文件

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

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

   前往 Database Migration Service“连接配置文件”页面

2. 点击创建配置文件。

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

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

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

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

4. 提供以下信息：
   • 在连接配置文件名称字段中，为源数据库的连接配置文件输入一个名称，例如 My Connection Profile。
   • 保留自动生成的连接配置文件 ID。
   • 输入连接信息：
     • 如果您要从自托管数据库复制数据，请输入用于访问主机的主机名或 IP 地址（网域或 IP）和端口。（默认 PostgreSQL 端口为 5432。）
     • 如果您要从 Cloud SQL 数据库复制数据，请从下拉列表中选择 Cloud SQL 实例。
   • 输入用户名和密码，对源实例进行身份验证。
   • （可选）如果您计划通过公共网络（使用 IP 许可名单）传输敏感信息，建议对源数据库和目标数据库之间的连接使用 SSL/TLS 加密。否则，请保留默认值 None。

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

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

6. 点击创建。

创建迁移作业

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

创建迁移作业包括：

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

定义迁移作业的设置

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

   前往 Database Migration Service 的“迁移作业”页面

2. 点击创建迁移作业。

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

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

5. 打开源数据库引擎下拉列表，然后选择源数据库的分类类型。

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

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

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

9. 点击保存并继续。

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

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

2. 点击保存并继续。

定义目标 Cloud SQL 实例的设置

1. 为 Cloud SQL 实例提供目标实例 ID。默认情况下，此字段中会预先填充迁移作业 ID。您可以保留此名称，也可以输入其他名称。

2. 为目标 Cloud SQL 实例提供字母数字密码。这将是实例中 postgres 管理员账号的密码。

   您可以手动输入密码，也可以点击生成以让 Database Migration Service 自动为您创建密码。

   提示：如需以明文形式查看密码，请点击显示图标。此图标看起来像一只眼睛。

3. 从指定数据库引擎支持的 Cloud SQL 版本列表中，为目标实例选择数据库版本。

4. 为新的 Cloud SQL 实例选择所需的 Google Cloud 可用区（或保留“不限”）。

5. 选择公共 IP 复选框，因为在本快速入门中，您将使用 IP 许可名单作为网络方法。此方法的工作原理是将源数据库服务器配置为接受来自 Cloud SQL 实例的传出 IP 地址的连接。

   对于其他网络方法（例如反向 SSH 隧道、VPC 对等互连或 VPN），请选中专用 IP 复选框。

6. 为 Cloud SQL 实例选择机器类型。磁盘大小必须等于或大于源数据库的大小。

7. 为 Cloud SQL 实例定义存储类型和存储容量。

8. 点击创建并继续以创建新实例。

9. 在后续对话框中，点击创建目标位置并继续。 创建实例可能需要几分钟才能完成。

   重要提示： 此过程会创建一个 Cloud SQL 实例。您需要根据选择的配置支付费用。
   注意： 创建目标实例后，迁移作业的某些设置将无法再进行修改。您无法更改数据库引擎或迁移类型。

设置连接

1. 选择您要在源数据库与目标数据库之间建立连接时使用的网络方法。在本快速入门中，使用连接方法列表选择 IP 许可名单作为网络方法。

   IP 许可名单是一项安全功能，通常用于仅限受信任的用户访问源数据库和目标数据库中的数据并控制对此数据的访问。您可以使用 IP 许可名单创建受信任的 IP 地址或 IP 范围列表，用户可通过这些地址访问此数据。此外，如需使用 IP 许可名单，您必须向来自目标 Cloud SQL 实例的传入连接开放源数据库或防火墙。

   IP 地址可能需要几分钟才能显示在目标传出 IP 地址字段中。

2. 如果此字段中未预先填充来源 IP 地址，请从控制台中复制 Cloud SQL 实例的传出 IP 地址，并使用该地址为源数据库服务器配置网络防火墙，以接受来自该 IP 地址的连接。
   
   1. 更新 pg_hba.conf 文件或 Amazon RDS 安全组，以接受来自此 IP 地址的连接。
   2. 在防火墙规则中，创建入站（或入站流量）规则，以允许从目标 Cloud SQL 实例的连接 IP 地址建立端口 5432 上的连接。
3. 点击配置并继续以完成连接配置文件配置。

配置迁移数据库

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

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

   源中的所有数据库都已选择进行迁移。

2. 点击保存并继续。

测试并创建迁移作业

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

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

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

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

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

5. 在后续对话框中，点击开始。

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

验证迁移作业

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

1. 前往 Google Cloud console中的 SQL 实例页面。
2. 点击迁移作业的读取副本条目。
3. 点击页面右上角显示的激活 Cloud Shell 图标。
4. 在 Google Cloud Shell 提示符处，按 Enter 键。
5. 可选：如果看到为 Cloud Shell 提供授权 对话框，请点击授权。
6. 连接到目标 Cloud SQL 数据库实例。
7. 在输入密码提示符处，输入您在定义目标 Cloud SQL 实例的设置中提供的密码或 Database Migration Service 为您生成的密码。

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

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

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

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

提升迁移作业

您已准备好提升迁移作业。这样一来，目标 Cloud SQL 数据库实例就会取代源数据库实例成为主数据库。

1. 返回迁移作业页面。

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

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

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

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

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

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

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

8. 在后续对话框中，再次点击提升。

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

新的 Cloud SQL 数据库实例已可供使用。

清理

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

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

后续步骤

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