迁移到新的目标实例

本页面介绍了如何将数据库迁移到 Database Migration Service 在您配置迁移作业时代表您创建的新 Cloud SQL for PostgreSQL 实例。如果您的迁移有不同的要求，请考虑遵循不同的迁移流程。如需了解详情，请参阅 指南：迁移到现有 Cloud SQL 实例。

概括来讲，迁移过程包含以下步骤：

1. 配置源数据库，以允许 Database Migration Service 将数据移动到新数据库。
2. 创建来源连接配置文件和迁移作业。
3. 根据您的连接配置，您可能需要调整防火墙设置。
4. 启动和监控迁移作业。
5. 提升迁移作业，并让应用改用新数据库。

费用

在本文档中，您将使用Google Cloud的以下收费组件：

• Cloud SQL（请参阅 Cloud SQL 价格。）
• 如果用于存储客户管理的加密密钥 (CMEK)：Cloud Storage（请参阅 Cloud Storage 价格）。

如需根据您的预计使用量来估算费用，请使用价格计算器。

准备工作

1. 验证此迁移路径是否可以完全支持您的场景。 请参阅以下页面：
   • 场景概览页面上的 支持的来源和目标列出了所有支持的来源和目标版本。
   • 已知限制介绍了支持的数据类型、数据库大小和其他限制。

   • 不同的源数据库可以使用不同的网络连接方法。在开始迁移过程之前，请考虑并规划网络连接。如需了解详情，请参阅 网络概览。

     迁移到新的目标实例不支持 Private Service Connect 接口连接。 如果您想使用 Private Service Connect 接口连接，请考虑直接在 Cloud SQL 中预先创建目标实例。 请参阅 指南：迁移到现有 Cloud SQL 实例。

2. 考虑要在哪个区域创建目标数据库。 Database Migration Service 是一款完全区域性的产品，这意味着与迁移相关的所有实体（源和目标连接配置文件、迁移作业、目标数据库、转换工作区）都必须保存在单个区域中。
3. 在 Google Cloud 控制台的项目选择器页面上，选择或 创建 Google Cloud 项目。

   转到“项目选择器”

4. 启用 Database Migration Service API 和 Cloud SQL Admin API。

   启用 API

所需的角色

如需获得使用 Database Migration Service 执行同构 PostgreSQL 迁移所需的权限，请让管理员向您授予项目的所需 IAM 角色：

• Database Migration Admin (roles/datamigration.admin)
• Cloud SQL Editor (roles/cloudsql.editor)
• Cloud SQL Studio User (roles/cloudsql.studioUser)

如需详细了解如何授予角色，请参阅 Identity and Access Management 文档中的 管理访问权限。

这些预定义角色包含使用 Database Migration Service 执行同构 PostgreSQL 迁移所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

如需使用 Database Migration Service 执行同构 PostgreSQL 迁移，您需要拥有以下权限：

• datamigration.*
• cloudsql.instances.create
• cloudsql.instances.get
• cloudsql.instances.list
• cloudsql.instances.update
• cloudsql.instances.delete
• cloudsql.operations.get
• cloudsql.users.list
• cloudsql.users.get
• cloudsql.users.create
• cloudsql.users.update
• cloudsql.users.delete

您也可以使用 自定义角色或其他 预定义角色来获取这些权限。

准备源数据库

如需准备要迁移的源数据，请按以下步骤操作：

1. 选择并配置源网络连接方法。

   对于公共 IP 许可清单连接性：稍后，在 Database Migration Service 创建目标实例后，您可能需要将 Cloud SQL 公共 IP 地址添加到防火墙许可清单中。请咨询您的网络管理员，了解如何以最佳方式安排此类配置更改。

2. 配置源数据库实例。概括来讲，这包括以下步骤：
   1. 在源数据库和所有要迁移的数据库上安装 pglogical PostgreSQL 扩展程序（2.2.1 版或更高版本）。
   2. 配置 PostgreSQL 参数：设置 wal_level = logical，并确保 max_replication_slots、max_wal_senders 和 max_worker_processes 的值足够。
   3. 向迁移用户授予复制权限，并配置 pg_hba.conf 以允许来自目标 Cloud SQL 实例的连接。

   如需详细说明，请参阅 配置源数据库。

3. 创建来源连接配置文件。

创建并运行迁移作业

注意：当 Database Migration Service 创建目标 Cloud SQL 实例时，该实例不会降级，也不会在只读模式下运行。但您必须避免对迁移中包含的表或数据库执行写入操作，以防止复制冲突。自动备份、时间点恢复 (PITR) 和创建读取副本功能会暂停，直到您提升迁移作业。如需了解详情，请参阅 已知限制。

如需配置和运行迁移，请执行以下步骤：

1. 可选：如果您想为目标实例管理自己的加密密钥，请 准备客户管理的加密密钥 (CMEK)。
2. 创建并运行迁移作业。

   您可以使用 Database Migration Service 可观测性功能监控迁移进度以及目标实例的运行状况。请参阅 迁移作业指标。

完成迁移

当您决定将应用切换到新的 Cloud SQL for PostgreSQL 实例时，请按照以下步骤完成迁移：

1. 可选： 设置级联读取副本。如果您想使用级联读取副本，可以在迁移作业进入 CDC 阶段时进行配置。
2. 停止对源数据库执行的所有写入操作。您可以将其切换为只读模式，以保留操作功能。
3. 提升迁移作业。
4. 可选： 验证迁移数据的完整性。

后续步骤

详细了解 Google Cloud Cloud SQL for PostgreSQL 的功能。请参阅 Cloud SQL for PostgreSQL 的特性。