GSP1084

概览

在 Google Cloud 中，您可以使用 Database Migration Service 将 PostgreSQL 数据库迁移到 AlloyDB for PostgreSQL。为此，AlloyDB 需要使用专用服务访问通道。在本实验环境中，为实现此访问通道，您需要在您的 VPC 网络与 AlloyDB 资源所在的底层 Google Cloud VPC 网络之间建立 VPC 对等互连连接。然后使用持续的 Database Migration Service 作业和 VPC 对等互连连接，将一个独立的 PostgreSQL 数据库（在虚拟机上运行）迁移到 AlloyDB for PostgreSQL。

使用 Database Migration Service 迁移数据库之前，您必须执行特定步骤来准备源数据库。这些准备任务（最重要的是设置 pglogical 软件包）已在源环境中为您预先完成。

创建并运行迁移作业后，您需要确认数据库的初始副本已成功迁移到您的 AlloyDB for PostgreSQL 实例。您还将探索持续迁移作业如何将源数据库中的数据更新应用到 AlloyDB for PostgreSQL 实例。

您将执行的操作

在本实验中，您将学习如何配置持续的 Database Migration Service 作业，以将数据库从 PostgreSQL 实例迁移到 AlloyDB for PostgreSQL。具体操作包括：

• 验证源实例中的数据适合迁移。
• 为源 PostgreSQL 实例（例如独立 PostgreSQL）创建连接配置文件。
• 创建并启动持续迁移作业。
• 确认数据已加载到 AlloyDB for PostgreSQL 实例中。
• 将实时更新传播到 AlloyDB 实例。

设置和要求

点击“开始实验”按钮前的注意事项

请阅读以下说明。实验是计时的，并且您无法暂停实验。计时器在您点击开始实验后即开始计时，显示 Google Cloud 资源可供您使用多长时间。

此实操实验可让您在真实的云环境中开展实验活动，免受模拟或演示环境的局限。为此，我们会向您提供新的临时凭据，您可以在该实验的规定时间内通过此凭据登录和访问 Google Cloud。

为完成此实验，您需要：

• 能够使用标准的互联网浏览器（建议使用 Chrome 浏览器）。

注意：请使用无痕模式（推荐）或无痕浏览器窗口运行此实验。这可以避免您的个人账号与学生账号之间发生冲突，这种冲突可能导致您的个人账号产生额外费用。

• 完成实验的时间 - 请注意，实验开始后无法暂停。

注意：请仅使用学生账号完成本实验。如果您使用其他 Google Cloud 账号，则可能会向该账号收取费用。

如何开始实验并登录 Google Cloud 控制台

1. 点击开始实验按钮。如果该实验需要付费，系统会打开一个对话框供您选择支付方式。左侧是“实验详细信息”窗格，其中包含以下各项：

   • “打开 Google Cloud 控制台”按钮
   • 剩余时间
   • 进行该实验时必须使用的临时凭据
   • 帮助您逐步完成本实验所需的其他信息（如果需要）

2. 点击打开 Google Cloud 控制台（如果您使用的是 Chrome 浏览器，请右键点击并选择在无痕式窗口中打开链接）。

   该实验会启动资源并打开另一个标签页，显示“登录”页面。

   提示：将这些标签页安排在不同的窗口中，并排显示。

   注意：如果您看见选择账号对话框，请点击使用其他账号。

3. 如有必要，请复制下方的用户名，然后将其粘贴到登录对话框中。

   {{{user_0.username | "<用户名>"}}}

   您也可以在“实验详细信息”窗格中找到“用户名”。

4. 点击下一步。

5. 复制下面的密码，然后将其粘贴到欢迎对话框中。

   {{{user_0.password | "<密码>"}}}

   您也可以在“实验详细信息”窗格中找到“密码”。

6. 点击下一步。

   重要提示：您必须使用实验提供的凭据。请勿使用您的 Google Cloud 账号凭据。 注意：在本实验中使用您自己的 Google Cloud 账号可能会产生额外费用。

7. 继续在后续页面中点击以完成相应操作：

   • 接受条款及条件。
   • 由于这是临时账号，请勿添加账号恢复选项或双重验证。
   • 请勿注册免费试用。

片刻之后，系统会在此标签页中打开 Google Cloud 控制台。

注意：如需访问 Google Cloud 产品和服务，请点击导航菜单，或在搜索字段中输入服务或产品的名称。

激活 Cloud Shell

Cloud Shell 是一种装有开发者工具的虚拟机。它提供了一个永久性的 5GB 主目录，并且在 Google Cloud 上运行。Cloud Shell 提供可用于访问您的 Google Cloud 资源的命令行工具。

1. 点击 Google Cloud 控制台顶部的激活 Cloud Shell 。

2. 在弹出的窗口中执行以下操作：

   • 继续完成 Cloud Shell 信息窗口中的设置。
   • 授权 Cloud Shell 使用您的凭据进行 Google Cloud API 调用。

如果您连接成功，即表示您已通过身份验证，且项目 ID 会被设为您的 Project_ID 。输出内容中有一行说明了此会话的 Project_ID：

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud 是 Google Cloud 的命令行工具。它已预先安装在 Cloud Shell 上，且支持 Tab 自动补全功能。

3. （可选）您可以通过此命令列出活跃账号名称：

gcloud auth list

4. 点击授权。

输出：

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. （可选）您可以通过此命令列出项目 ID：

gcloud config list project

输出：

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} 注意：如需查看在 Google Cloud 中使用 gcloud 的完整文档，请参阅 gcloud CLI 概览指南。

任务 1. 验证源实例中的数据适合迁移

在此任务中，您将连接到 pg14-source 虚拟机实例上的 postgres 数据库，并验证其中的数据。

验证源实例中的数据

1. 在导航菜单 () 中，点击 Compute Engine 下的虚拟机实例。

2. 对名为 pg14-source 的实例，在连接列中点击 SSH，打开一个终端窗口。

3. 使用以下命令启动 PostgreSQL (psql) 客户端：

sudo -u postgres psql

随后系统会显示 psql 终端提示符，如下所示：

psql (14.5 (Debian 14.5-1.pgdg110+1)) Type "help" for help.

4. 输入并运行以下 SQL 命令，以查看 postgres 数据库中与 HR 相关的表：

\dt

5. 运行以下查询，确定每个表的行数：

select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;

源表的行数如下所示：

名称	行数
countries	25
departments	27
employees	107
jobs	19
locations	23
regions	4

6. 输入 \q 以退出 psql 客户端。

7. 输入 exit 以关闭终端窗口。

任务 2. 为独立 PostgreSQL 数据库创建 Database Migration Service 连接配置文件

在此任务中，您将为 PostgreSQL 源实例创建连接配置文件。

获取 PostgreSQL 源实例的连接和部署信息

您需要获取源数据库实例的内部 IP 地址，以便将数据库迁移到 AlloyDB。

1. 仍然停留在“虚拟机实例”页面中，找到 pg14-source 实例。

2. 记录内部 IP（例如 10.128.15.208)。

为 PostgreSQL 源实例创建新的连接配置文件

连接配置文件中存储着有关源数据库实例（例如独立 PostgreSQL）的信息。Database Migration Service 使用连接配置文件将数据从源数据库迁移到目标数据库。创建连接配置文件后，可以在迁移作业中重复使用此配置文件。

在此步骤中，您将为 PostgreSQL 源实例创建一个新的连接配置文件。

1. 在 Google Cloud 控制台的导航菜单 () 中，点击查看所有产品。

2. 在数据库类别中，点击数据库迁移。

3. 在左侧窗格中，点击连接配置文件，然后点击创建配置文件。

4. 参照下方信息设置相关字段。将其他所有字段保留默认值。

字段	值
源引擎	PostgreSQL
目标引擎	Cloud SQL for PostgreSQL
选择要创建的配置文件类型	来源
连接配置文件名称	pg14-source
区域
PostgreSQL 到 PostgreSQL	点击定义。
PostgreSQL 到 PostgreSQL	输入您之前记录的 PostgreSQL 源实例的内部 IP（例如 10.128.15.208)
端口	5432
用户名	postgres
密码	Change3Me

5. 点击保存。

6. 点击创建。

一个名为 pg14-source 的新连接配置文件即会显示在连接配置文件列表中。

点击检查我的进度以验证是否完成了以下目标： 为 PostgreSQL 源实例创建连接配置文件

任务 3. 创建并启动持续迁移作业

在创建新的迁移作业时，首先需要使用先前创建的连接配置文件定义源数据库实例。然后，创建一个新的目标数据库实例，并配置源实例与目标实例之间的连接。

在此任务中，您将使用迁移作业界面来创建一个新的 AlloyDB for PostgreSQL 集群，并将其设置为从 PostgreSQL 源实例迁移数据的持续迁移作业的目标位置。

创建新的持续迁移作业

在此步骤中，您将创建一个新的持续迁移作业。

1. 仍然停留在“数据库迁移”页面中，点击左侧窗格中的迁移作业。

2. 点击创建迁移作业。

开始

1. 设置以下字段，并将其他所有设置保留默认值。

字段	值
迁移作业名称	postgres-to-alloydb
源数据库引擎	PostgreSQL
目标数据库引擎	AlloyDB for PostgreSQL
目标区域

2. 点击保存并继续。

指定来源

1. 在选择来源连接配置文件部分，选择您在几个步骤前创建的 pg14-source 连接配置文件。

2. 点击保存并继续。

指定目标位置

1. 对于目标集群类型，选择现有集群。

2. 对于集群 ID，选择 alloydb-target-cluster。

3. 点击选择并继续。

4. 当系统提示您确认时，输入 alloydb-target-cluster 进行确认，然后点击确认并继续。

指定连接方法

1. 对于连接方法，选择 VPC 对等互连。

2. 点击配置并继续。

配置迁移数据库

1. 将要迁移的数据库设置为所有数据库。

2. 点击保存并继续。

测试并创建迁移作业

1. Database Migration Service 向导现在将开始测试并创建迁移作业步骤。

2. 点击测试作业。

3. 在测试成功后，点击创建并启动作业。

注意：您必须点击创建并启动作业，作业才会开始。另一个链接只会创建并保存作业详情。

4. 如果系统提示您确认，请点击创建并启动。

postgres-to-alloydb 详情页面随即打开。

查看持续迁移作业的状态

1. 在 postgres-to-alloydb 详情页面中，查看迁移作业的状态。

• 如果作业尚未启动，其状态会显示为尚未开始。您可以选择启动或删除该作业。
• 作业启动后，状态将显示为正在启动，然后变为正在运行，表示正在执行初始数据库转储。
• 在初始加载完成且 DMS 可用于持续操作时，作业状态将变为正在运行，而阶段将显示为 CDC。

2. 当作业状态变为正在运行且阶段显示为 CDC 时，继续执行下一项任务。

任务 4. 确认数据已加载到 AlloyDB for PostgreSQL 实例中

检查 AlloyDB for PostgreSQL 实例

1. 在 Google Cloud 控制台的导航菜单 () 中，点击查看所有产品。在数据库类别中，点击 AlloyDB for PostgreSQL，然后点击集群以查看集群列表。

集群名为 alloydb-target-cluster，实例名为 alloydb-target-instance。

2. 点击 alloydb-target-cluster，然后在左侧窗格中点击连接。

3. 记录专用 IP 地址，例如 10.24.0.2。

请注意，如果您点击复制到剪贴板来复制专用 IP 地址，端口号也会包含在其中（例如 10.24.0.2:5432）。仅记录 IP 地址（例如 10.24.0.2），以供后续步骤使用。

4. 在导航菜单 () 中，点击 Compute Engine 下的虚拟机实例。

5. 对于 alloydb-client 实例，点击 SSH 以打开终端窗口。

6. 设置以下环境变量，并将 [ALLOYDB_ADDRESS] 替换为 AlloyDB 实例的专用 IP 地址（例如 10.24.0.2）：

export ALLOYDB=[ALLOYDB_ADDRESS]

7. 运行以下命令，将 AlloyDB 实例的专用 IP 地址存储在 AlloyDB 客户端虚拟机上，以便在整个实验过程中保留该地址：

echo $ALLOYDB > alloydbip.txt

8. 连接到 psql 客户端并运行以下查询，以验证 AlloyDB 实例现在包含五个源表。在系统提示时，提供 postgres 用户的密码 (Change3Me)，该密码是在创建集群时指定的：

psql -h $ALLOYDB -U postgres \dt List of relations Schema | Name | Type | Owner --------+-------------+-------+--------------------- public | countries | table | alloydbexternalsync public | departments | table | alloydbexternalsync public | employees | table | alloydbexternalsync public | jobs | table | alloydbexternalsync public | locations | table | alloydbexternalsync public | regions | table | alloydbexternalsync (6 rows)

9. 运行以下查询，确定已迁移表的行数。这些值将与源实例上的查询输出相匹配：

select count (*) as countries_row_count from countries; select count (*) as departments_row_count from departments; select count (*) as employees_row_count from employees; select count (*) as jobs_row_count from jobs; select count (*) as locations_row_count from locations; select count (*) as regions_row_count from regions;

目标表的行数如下：

名称	行数
countries	25
departments	27
employees	107
jobs	19
locations	23
regions	4

10. 运行以下查询，验证 regions 表中的数据：

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa (4 rows) .

请不要关闭此终端窗口，以便在下一部分中使用。

任务 5. 将实时更新传播到 AlloyDB 实例

由于 Database Migration Service 作业设置为持续更新配置，因此您对源实例所做的任何更新都将应用于 AlloyDB 目标。

1. 返回 Google Cloud 控制台。

2. 对于 pg14-source 实例，点击 SSH 以打开终端窗口。

3. 使用以下命令启动 PostgreSQL (psql) 客户端：

sudo -u postgres psql

4. 在 psql 终端提示符处，输入并运行以下 SQL 命令，向 regions 表中添加一行数据：

insert into regions values (5, 'Oceania');

5. 确认该行已在本地插入：

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa 5 | Oceania (5 rows)

查看 AlloyDB for PostgreSQL 实例中的数据

1. 返回 alloydb-client 的终端 shell。psql 客户端仍处于打开状态。运行以下查询，验证 Oceania 行已经添加到目标 AlloyDB 实例。

select region_id, region_name from regions; region_id | region_name -----------+------------------------ 1 | Europe 2 | Americas 3 | Asia 4 | Middle East and Africa 5 | Oceania (5 rows)

2. 点击检查我的进度以验证是否完成了以下目标： 测试数据的持续迁移

恭喜！

您现在已使用持续的 Database Migration Service 作业，成功将一个独立 PostgreSQL 数据库（在虚拟机上运行）迁移到 AlloyDB for PostgreSQL。

后续步骤/了解详情

详细了解数据迁移、Cloud SQL 数据库和 Database Migration Service：

• Database Migration Service 文档
• “迁移到 AlloyDB for PostgreSQL”文档

Google Cloud 培训和认证

…可帮助您充分利用 Google Cloud 技术。我们的课程会讲解各项技能与最佳实践，可帮助您迅速上手使用并继续学习更深入的知识。我们提供从基础到高级的全方位培训，并有点播、直播和虚拟三种方式选择，让您可以按照自己的日程安排学习时间。各项认证可以帮助您核实并证明您在 Google Cloud 技术方面的技能与专业知识。

上次更新手册的时间：2025 年 12 月 15 日

上次测试实验的时间：2025 年 11 月 24 日

版权所有 2026 Google LLC 保留所有权利。Google 和 Google 徽标是 Google LLC 的商标。其他所有公司名和产品名可能是其各自相关公司的商标。