使用 Database Migration Service 进行快速启动迁移

本页面介绍了如何执行同构 PostgreSQL 到 AlloyDB for PostgreSQL 的快速入门迁移。

概览

快速启动迁移是一种轻量级的持续迁移流程，适用于同构 PostgreSQL 场景。借助快速启动迁移，Database Migration Service 可以自动设置迁移数据库所需的一切：网络组件（网络附加、子网、专用连接配置）、连接配置文件和迁移作业。

借助快速入门迁移，您可以将数据迁移到现有的 AlloyDB for PostgreSQL 集群，也可以在配置迁移时创建一个新集群。快速启动迁移最适合以下情况：

  • 基本迁移，您无需精确控制数据转储并行设置。
  • 将数据库从一个 Google Cloud 项目迁移到另一个项目。 配置快速入门迁移时，您可以在与源项目不同的项目中创建目标集群，并将 Database Migration Service 设置为在另一个项目的 Virtual Private Cloud (VPC) 网络中创建网络连接和子网。

  • 从 Google Cloud虚拟私有云 (VPC) 网络中具有专用 IP 地址的来源迁移，例如 Compute Engine 上的自管理数据库，或已启用专用网络的 Cloud SQL for PostgreSQL 实例。

    托管在 Google Cloud 之外的来源可能需要额外的网络组件（例如 Cloud VPN 连接），以便可以通过 VPC 网络中的专用 IP 地址访问这些来源。

  • 唯一受支持的数据库连接方法是使用 Private Service Connect 接口和 Database Migration Service 专用连接配置。您的源数据库需要在 VPC 网络中分配有专用 IP。快速启动迁移不支持其他同构源连接方法（例如公共 IP 许可名单、反向 SSH 隧道或 VPC 对等互连）。

如需详细了解快速启动迁移，请参阅 Database Migration Service 文档中的快速启动迁移。

准备工作

  1. 验证快速启动迁移是否能完全支持您的方案。请参阅 Database Migration Service 文档中的快速启动迁移限制。

  2. 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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. 启用 Database Migration Service、Compute Engine、Network Connectivity Center 和 AlloyDB for PostgreSQL Admin API。

    启用 API

所需的角色

如需获得使用 Database Migration Service 将数据快速迁移到 AlloyDB for PostgreSQL 所需的权限，请让管理员在相关项目中为迁移所涉及的账号授予所需的 Identity and Access Management (IAM) 角色。如需详细了解如何授予角色，请参阅 IAM 文档中的管理访问权限。

源项目中的角色和权限

在源数据库所在的 Google Cloud 项目中，向特定账号授予以下角色：

  • 对于执行迁移的用户账号： Compute Network Admin (roles/compute.networkAdmin)
  • 对于目标项目的 Database Migration Service 服务账号： Compute Network Viewer (roles/compute.networkViewer)

    启用 Database Migration Service API 后，系统会为您创建 Database Migration Service 服务账号。与此账号关联的电子邮件地址是自动生成的，无法更改。此电子邮件地址采用以下格式： 

    service-DESTINATION_PROJECT_NUMBERservice-DESTINATION_PROJECT_NUMBER@gcp-sa-datamigration.

这些预定义角色包含在通过 Database Migration Service 进行快速入门迁移时，在源数据库项目中设置连接所需的权限。如需查看所需的确切权限，请展开所需权限（来源）部分：

所需权限（来源）

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

对于执行迁移的用户账号：

  • compute.networks.*
  • compute.subnetworks.*
  • compute.networkAttachments.*

对于目标项目的 Database Migration Service 服务账号：compute.networkAttachments.get。

目标项目中的角色和权限

向在 Google Cloud 项目（即目标数据库所在的项目）中执行迁移的用户账号授予以下角色：

这些预定义角色包含在目标数据库项目中设置所需迁移组件所需的权限，以便使用 Database Migration Service 进行快速启动迁移。如需查看所需的确切权限，请展开所需权限（目标位置）部分：

所需权限（目标）

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

  • datamigration.*
  • alloydb.clusters.create
  • alloydb.clusters.get
  • alloydb.clusters.list
  • alloydb.clusters.update
  • alloydb.clusters.delete
  • alloydb.instances.create
  • alloydb.instances.get
  • alloydb.instances.list
  • alloydb.instances.update
  • alloydb.instances.delete
  • alloydb.instances.executeSql
  • alloydb.operations.get
  • alloydb.users.list
  • alloydb.users.get
  • alloydb.users.create
  • alloydb.users.update
  • alloydb.users.delete

配置源数据库

如需配置源 PostgreSQL 数据库，请执行以下操作：

  1. 在实例中创建专用的迁移用户账号。
    • 对于 Cloud SQL for PostgreSQL 来源，请参阅 Cloud SQL 文档中的创建用户。
    • 如需了解其他来源，请参阅数据库提供商文档或 PostgreSQL 文档中的 创建和管理用户。
  2. 向专用迁移用户账号分配必要的权限。 针对要迁移的每个数据库运行以下命令： 
    -- Grant the REPLICATION attribute
ALTER ROLE MIGRATION_USER REPLICATION;

-- Grant database-level permissions.
-- Repeat for each database you want to migrate.
GRANT CONNECT, CREATE ON DATABASE DATABASE_NAME TO MIGRATION_USER;

-- Grant schema-level usage.
-- Repeat for each schema in each database you want to migrate.
GRANT USAGE ON SCHEMA SCHEMA_NAME TO MIGRATION_USER;

    替换以下内容：

    • 将 MIGRATION_USER 替换为迁移用户账号的名称。
    • 将 DATABASE_NAME 替换为要迁移的数据库的名称。
    • 将 SCHEMA_NAME 替换为要迁移的数据库中的架构名称。
  3. 迁移用户账号需要对您迁移的表拥有所有权访问权限。如需授予此级别的访问权限，请执行以下操作之一：
    • 仅针对 Cloud SQL for PostgreSQL 以外的来源：为迁移账号分配 SUPERUSER PostgreSQL 角色。
    • 对于所有来源：将迁移用户账号添加到拥有相应表的用户组。运行以下命令： 
      -- Grant table ownership.
GRANT TABLE_OWNER_GROUP_NAME TO MIGRATION_USER;

      替换以下内容：

      • TABLE_OWNER_GROUP_NAME，其中包含您要迁移的每个表所属的用户组的名称。
      • 将 MIGRATION_USER 替换为迁移用户账号的名称。
  4. 对于没有主键的表：在变更数据捕获 (CDC) 阶段，Database Migration Service 不会复制没有主键的表的 UPDATE 或 DELETE 操作。如果您想在复制中包含此类操作，请使用 REPLICA IDENTITY 修改没有主键的表： 
    ALTER TABLE TABLE_NAME REPLICA IDENTITY FULL;
ALTER TABLE TABLE_NAME REPLICA IDENTITY USING INDEX INDEX_NAME;

    替换以下内容：

    • TABLE_NAME 是没有主键的表的名称。
    • INDEX_NAME 是可以跟踪没有主键的表中的行的唯一索引。
  5. 使用数据库标志配置复制设置。

    自行管理的来源

    保存对数据库标志的更改需要完全重启数据库。 以下示例使用 SQL 查询来更改标志值。 如果您无法直接运行 SQL 查询，请参阅提供商文档，了解有关更改这些标志的步骤。

    1. 将 wal_level 参数设置为 logical。运行以下命令： 
      ALTER SYSTEM SET wal_level = 'logical';
    2. 将 wal_sender_timeout 参数设置为 0。 此值可停用用于终止非活跃复制连接的超时机制。运行以下命令： 
      ALTER SYSTEM SET wal_sender_timeout = 0;
    3. 使用 max_replication_slots 参数配置复制槽数上限。此参数必须设置为至少等于每个迁移作业中要迁移的数据库数量，并预留一部分用于表同步。

      例如，如果您要迁移 5 个数据库，并且为源实例创建了 2 个迁移作业，那么除了您已经使用的复制槽数量之外，复制槽的数量必须至少为 5 * 2 = 10。

      如需设置此参数，请运行以下命令：

      ALTER SYSTEM SET max_replication_slots = NUMBER_OF_SLOTS;
      其中，NUMBER_OF_SLOTS 表示复制槽的最大数量。
    4. 将 max_wal_senders 参数配置为至少与 max_replication_slots 相同的值，再加上实例中已使用的发送方数量。

      例如，如果 max_replication_slots 参数设置为 10，并且您已经使用 2 个发送器，则同时运行的 WAL 发送器进程的数量将为 10 + 2 = 12。

      如需设置此参数，请运行以下命令：

      ALTER SYSTEM SET max_wal_senders = NUMBER_OF_SENDERS;
      其中，NUMBER_OF_SENDERS 表示同时运行的 WAL 发送器进程数。
    5. 将 max_worker_processes 设置为至少是您要迁移的数据库数量加上实例中已使用的 max_worker_processes 数量。 如需设置此参数，请运行以下命令： 
      ALTER SYSTEM SET max_worker_processes = NUMBER_OF_PROCESSES;
      其中，NUMBER_OF_PROCESSES 表示将迁移的数据库数量。

    Cloud SQL for PostgreSQL 来源

    对于 Cloud SQL 源，您可以在 Google Cloud 控制台中配置数据库标志。 修改数据库标志后，您必须重启实例，设置才会生效。如需详细了解如何在 Cloud SQL 中设置数据库标志，请参阅 Cloud SQL 文档中的配置数据库标志。

    1. 将 cloudsql.logical_decoding 标志设置为 on。
    2. 将 wal_sender_timeout 参数设置为 0。 此值可停用用于终止非活跃复制连接的超时机制。
    3. 使用 max_replication_slots 参数配置复制槽数上限。此参数必须设置为至少等于每个迁移作业中要迁移的数据库数量，并预留一部分用于表同步。

      例如，如果您要迁移 5 个数据库，并且为源实例创建了 2 个迁移作业，那么除了您已经使用的复制槽数量之外，复制槽的数量必须至少为 5 * 2 = 10。

    4. 将 max_wal_senders 参数配置为至少与 max_replication_slots 相同的值，再加上实例中已使用的发送方数量。

      例如，如果 max_replication_slots 参数设置为 10，并且您已经使用 2 个发送器，则同时运行的 WAL 发送器进程的数量将为 10 + 2 = 12。

    5. 将 max_worker_processes 设置为至少等于您要迁移的数据库数量加上实例中已使用的 max_worker_processes 数量。

创建并运行快速启动迁移

使用快速入门迁移时，您可以创建新的 AlloyDB for PostgreSQL 集群并将数据库迁移到该集群，也可以将数据库迁移到现有集群。

新集群的快速启动迁移

如需创建新的 AlloyDB for PostgreSQL 集群并立即将数据库迁移到该集群，请按以下步骤操作：

控制台

  1. 前往集群页面。

    前往“集群”

  2. 依次点击创建集群 > 从现有数据库创建

    系统会打开 Database Migration Service 快速启动迁移表单。

  3. 在配置迁移部分中，执行以下操作：
    1. 从目标区域菜单中，选择目标 AlloyDB for PostgreSQL 集群的区域。
    2. 在迁移前缀框中，输入一个字符串，该字符串将添加到为快速启动迁移创建的所有迁移实体（连接配置文件、专用连接配置、网络连接及其子网，以及迁移作业）的名称中。
    3. 从配置类型菜单中，选择以下选项之一：
      1. 现有连接配置：如果您已拥有网络连接和使用 Private Service Connect 接口方法的专用连接配置，请选择此选项。 如果您之前使用过快速启动迁移，并且想重复使用相同的网络资源，最好使用此选项。
      2. 新的连接配置：选择此选项可在源数据库 VPC 网络中创建新的网络连接和网络连接子网。 专用连接配置将在与目标集群相同的项目中创建。
      4. 点击继续。
  4. 在连接来源部分，执行以下操作：
    1. 输入源数据库的主机名或私有 IP 地址。源数据库地址必须可从源 VPC 网络访问。
    2. 输入用于访问主机的端口。默认 PostgreSQL 端口号为 5432。
    3. 输入源数据库中专用迁移账号的用户名和密码。
    4. 从加密类型菜单中，选择以下选项之一：
      • 无：如果源数据库不需要 SSL/TLS 加密连接。
      • 必需：如果源数据库要求使用 SSL/TLS 加密的连接。此选项不需要进行任何证书验证。
    5. 在要迁移的数据库菜单中，点击自定义。 使用侧边栏仅选择要迁移到 AlloyDB for PostgreSQL 的数据库。
      6. 点击继续。
  5. 在配置目的地部分中，执行以下操作：
    1. 在目标实例类型菜单中，选择新集群。

      Database Migration Service 会为新集群使用默认的 AlloyDB for PostgreSQL 配置。点击自定义以调整集群功能，例如机器类型、可用区可用性或数据保护设置。 如需详细了解集群配置，请参阅 创建集群及其主实例。

    2. 在密码字段中，输入默认 postgresql 管理员用户的密码。Database Migration Service 会以该用户身份连接，以便迁移您的数据。
  6. 点击开始迁移。

    Database Migration Service 现在会创建迁移作业并开始迁移流程。您可以监控迁移进度，以及 AlloyDB for PostgreSQL 中目标集群的健康状况。如需了解详情，请参阅查看集群信息。

gcloud

如需使用 gcloud CLI 迁移到新的 AlloyDB 集群，请执行以下步骤：

  1. 创建网络连接资源。
    在源数据库所在的项目和虚拟私有云网络中创建网络连接：

    gcloud compute network-attachments create NETWORK_ATTACHMENT \
  --region=REGION \
  --connection-preference=ACCEPT_MANUAL \
  --producer-accept-list=DEST_PROJECT_ID \
  --subnets=default \
  --project=SOURCE_PROJECT_ID

    替换以下内容：

    • NETWORK_ATTACHMENT：要创建的网络连接的名称。
    • REGION：网络连接的区域。
    • DEST_PROJECT_ID：目标项目的项目 ID。
    • SOURCE_PROJECT_ID：源网络所在项目的 ID。

  2. 允许 Database Migration Service 租户项目访问网络连接。
    通过运行验证检查来检索租户项目 ID，然后更新网络连接接受列表以包含该 ID：

    1. 执行验证检查以检索租户项目 ID：

      gcloud database-migration private-connections create PRIVATE_CONN \
  --region=REGION \
  --network-attachment=NETWORK_ATTACHMENT_URI \
  --display-name=PRIVATE_CONN \
  --format="value(metadata.metadata.tenant_project_id)" \
  --validate-only

      替换以下内容：

      • PRIVATE_CONN：专用连接资源的名称。
      • REGION：专用连接所在的区域。
      • NETWORK_ATTACHMENT_URI：在上一步中创建的网络连接的 URI。例如 projects/SOURCE_PROJECT_ID/regions/REGION/networkAttachments/NETWORK_ATTACHMENT。

    2. 使用检索到的 DMS_TENANT_ID 更新网络连接：

      gcloud compute network-attachments update NETWORK_ATTACHMENT \
  --region=REGION \
  --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID \
  --project=SOURCE_PROJECT_ID

      替换以下内容：

      • NETWORK_ATTACHMENT：网络连接的名称。
      • REGION：区域。
      • DEST_PROJECT_ID：目标项目的项目 ID。
      • DMS_TENANT_ID：检索到的 Database Migration Service 租户项目 ID。
      • SOURCE_PROJECT_ID：源网络所在项目的 ID。

  3. 创建专用连接配置。
    在目标项目中创建专用连接：

    gcloud database-migration private-connections create PRIVATE_CONN \
  --region=REGION \
  --network-attachment=NETWORK_ATTACHMENT_URI \
  --display-name=PRIVATE_CONN

    替换以下内容：

    • PRIVATE_CONN：专用连接资源的名称。
    • REGION：专用连接所在的区域。
    • NETWORK_ATTACHMENT_URI：网络连接的 URI。

  4. 创建来源连接配置文件。
    为源 PostgreSQL 数据库创建连接配置文件：

    gcloud database-migration connection-profiles create postgresql SOURCE_CONN_ID \
  --region=REGION \
  --role=SOURCE \
  --host=SOURCE_PRIVATE_IP \
  --port=SOURCE_PORT \
  --username=SOURCE_USER \
  --password=SOURCE_PASSWORD \
  --private-connection=PRIVATE_CONN \
  --no-async

    替换以下内容：

    • SOURCE_CONN_ID：源连接配置文件的标识符。
    • REGION：您要在其中保存连接配置文件的区域。
    • SOURCE_PRIVATE_IP：源数据库的专用 IP 地址。
    • SOURCE_PORT：源数据库的端口（默认为 5432）。
    • SOURCE_USER：源数据库中迁移用户的用户名。
    • SOURCE_PASSWORD：源数据库中迁移用户的密码。
    • PRIVATE_CONN：专用连接资源的名称。

  5. 创建目标 AlloyDB 集群。
    创建目标集群及其主实例。如需查看详细说明，请参阅创建集群及其主实例页面。

  6. 创建目标连接配置文件。
    创建指向新创建的 AlloyDB 集群的目标连接配置文件：

    gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \
  --region=REGION \
  --alloydb-cluster=DEST_CLUSTER \
  --username=DEST_USER \
  --password=DEST_PASSWORD \
  --role=DESTINATION \
  --no-async

    替换以下内容：

    • DEST_CONN_ID：目标连接配置文件的标识符。
    • REGION：您要在其中保存连接配置文件的区域。此区域必须与目标集群区域相同。
    • DEST_CLUSTER：AlloyDB for PostgreSQL 目标集群的 ID 或完整资源路径。
    • DEST_USER：目标数据库中迁移用户的用户名。
    • DEST_PASSWORD：目标数据库中迁移用户的密码。

  7. 创建迁移作业。
    创建启用了原生复制功能的持续迁移作业：

    gcloud database-migration migration-jobs create MIGRATION_JOB_ID \
  --region=REGION \
  --type=CONTINUOUS \
  --source=SOURCE_CONN_ID \
  --destination=DEST_CONN_ID \
  --use-postgres-native \
  --postgres-max-additional-subscriptions=10 \
  --databases-filter=DATABASES_LIST \
  --no-async

    替换以下内容：

    • MIGRATION_JOB_ID：迁移作业标识符。
    • REGION：您要保存迁移作业的区域。
    • SOURCE_CONN_ID：源连接配置文件标识符。
    • DEST_CONN_ID：目标连接配置文件的标识符。
    • DATABASES_LIST：要迁移的数据库的英文逗号分隔列表。

  8. 启动迁移作业。
    启动迁移作业以开始复制流程：

    gcloud database-migration migration-jobs start MIGRATION_JOB_ID \
  --region=REGION

    替换以下内容：

    • MIGRATION_JOB_ID：迁移作业的标识符。
    • REGION：迁移作业所在的区域。

现有集群的快速启动迁移

如需将数据库迁移到现有的 AlloyDB for PostgreSQL 集群，请按照以下步骤操作：

控制台

  1. 前往集群页面。

    前往“集群”

  2. 选择要将数据库迁移到的 AlloyDB for PostgreSQL 集群。
  3. 在集群详情页面上，点击迁移数据。
  4. 在迁移数据面板中，点击迁移数据库。

    系统会打开 Database Migration Service 快速启动迁移表单。

  5. 在配置迁移部分中，执行以下操作：
    1. 从目标区域菜单中，选择目标 AlloyDB for PostgreSQL 集群的区域。
    2. 在迁移前缀框中，输入一个字符串，该字符串将添加到为快速启动迁移创建的所有迁移实体（连接配置文件、专用连接配置、网络连接及其子网，以及迁移作业）的名称中。
    3. 从配置类型菜单中，选择以下选项之一：
      1. 现有连接配置：如果您已拥有网络连接和专用连接配置，并且该配置在源数据库 VPC 网络中使用 Private Service Connect 接口，请选择此选项。如果您之前使用过快速启动迁移，并希望重复使用相同的网络资源，则最好使用此选项。
      2. 新的连接配置：选择此选项可在源数据库 VPC 网络中创建新的网络连接、网络连接子网和专用连接配置。
  6. 在连接来源部分，执行以下操作：
    1. 输入源数据库的主机名或私有 IP 地址。源数据库地址必须可从源 VPC 网络访问。
    2. 输入用于访问主机的端口。默认的 PostgreSQL 端口为 5432。
    3. 输入源数据库中专用迁移账号的用户名和密码。
    4. 从加密类型菜单中，选择以下选项之一：
      • 无：如果源数据库不需要 SSL/TLS 加密连接。
      • 必需：如果源数据库要求使用 SSL/TLS 加密的连接。此选项不需要进行任何证书验证。
    5. 在要迁移的数据库菜单中，点击自定义。 使用侧边栏仅选择要迁移到 AlloyDB for PostgreSQL 的数据库。
  7. 点击开始迁移。

    Database Migration Service 现在会创建迁移作业并开始迁移流程。您可以监控迁移进度，以及 AlloyDB for PostgreSQL 中目标集群的健康状况。如需了解详情，请参阅查看集群信息。

gcloud

如需使用 gcloud CLI 迁移到现有 AlloyDB 集群，请执行以下步骤：

  1. 创建网络连接资源。
    在源数据库所在的项目和 VPC 网络中创建网络连接：

    gcloud compute network-attachments create NETWORK_ATTACHMENT \
  --region=REGION \
  --connection-preference=ACCEPT_MANUAL \
  --producer-accept-list=DEST_PROJECT_ID \
  --subnets=default \
  --project=SOURCE_PROJECT_ID

    替换以下内容：

    • NETWORK_ATTACHMENT：要创建的网络连接的名称。
    • REGION：网络连接的区域。
    • DEST_PROJECT_ID：目标项目的项目 ID。
    • SOURCE_PROJECT_ID：源网络所在项目的 ID。

  2. 允许 Database Migration Service 租户项目访问网络连接。
    通过运行验证检查来检索租户项目 ID，然后更新网络连接接受列表以包含该 ID：

    1. 执行验证检查以检索租户项目 ID：

      gcloud database-migration private-connections create PRIVATE_CONN \
  --region=REGION \
  --network-attachment=NETWORK_ATTACHMENT_URI \
  --display-name=PRIVATE_CONN \
  --format="value(metadata.metadata.tenant_project_id)" \
  --validate-only

      替换以下内容：

      • PRIVATE_CONN：专用连接资源的名称。
      • REGION：专用连接所在的区域。
      • NETWORK_ATTACHMENT_URI：在上一步中创建的网络连接的 URI。例如 projects/SOURCE_PROJECT_ID/regions/REGION/networkAttachments/NETWORK_ATTACHMENT。

    2. 使用检索到的 DMS_TENANT_ID 更新网络连接：

      gcloud compute network-attachments update NETWORK_ATTACHMENT \
  --region=REGION \
  --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID \
  --project=SOURCE_PROJECT_ID

      替换以下内容：

      • NETWORK_ATTACHMENT：网络连接的名称。
      • REGION：区域。
      • DEST_PROJECT_ID：目标项目的项目 ID。
      • DMS_TENANT_ID：检索到的 Database Migration Service 租户项目 ID。
      • SOURCE_PROJECT_ID：源网络所在项目的 ID。

  3. 创建专用连接配置。
    在目标项目中创建专用连接：

    gcloud database-migration private-connections create PRIVATE_CONN \
  --region=REGION \
  --network-attachment=NETWORK_ATTACHMENT_URI \
  --display-name=PRIVATE_CONN

    替换以下内容：

    • PRIVATE_CONN：专用连接资源的名称。
    • REGION：专用连接所在的区域。
    • NETWORK_ATTACHMENT_URI：网络连接的 URI。

  4. 创建来源连接配置文件。
    为源 PostgreSQL 数据库创建连接配置文件：

    gcloud database-migration connection-profiles create postgresql SOURCE_CONN_ID \
  --region=REGION \
  --role=SOURCE \
  --host=SOURCE_PRIVATE_IP \
  --port=SOURCE_PORT \
  --username=SOURCE_USER \
  --password=SOURCE_PASSWORD \
  --private-connection=PRIVATE_CONN \
  --no-async

    替换以下内容：

    • SOURCE_CONN_ID：源连接配置文件的标识符。
    • REGION：您要在其中保存连接配置文件的区域。
    • SOURCE_PRIVATE_IP：源数据库的专用 IP 地址。
    • SOURCE_PORT：源数据库的端口（默认为 5432）。
    • SOURCE_USER：源数据库中迁移用户的用户名。
    • SOURCE_PASSWORD：源数据库中迁移用户的密码。
    • PRIVATE_CONN：专用连接资源的名称。

  5. 创建目标连接配置文件。
    创建指向预先创建的目标 AlloyDB 集群的目标连接配置文件：

    gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \
  --region=REGION \
  --alloydb-cluster=DEST_CLUSTER \
  --username=DEST_USER \
  --password=DEST_PASSWORD \
  --role=DESTINATION \
  --no-async

    替换以下内容：

    • DEST_CONN_ID：目标连接配置文件的标识符。
    • REGION：您要在其中保存连接配置文件的区域。此区域必须与目标集群区域相同。
    • DEST_CLUSTER：AlloyDB for PostgreSQL 目标集群的 ID 或完整资源路径。
    • DEST_USER：目标数据库中迁移用户的用户名。
    • DEST_PASSWORD：目标数据库中迁移用户的密码。

  6. 创建迁移作业。
    创建启用了原生复制功能的持续迁移作业：

    gcloud database-migration migration-jobs create MIGRATION_JOB_ID \
  --region=REGION \
  --type=CONTINUOUS \
  --source=SOURCE_CONN_ID \
  --destination=DEST_CONN_ID \
  --use-postgres-native \
  --postgres-max-additional-subscriptions=10 \
  --databases-filter=DATABASES_LIST \
  --no-async

    替换以下内容：

    • MIGRATION_JOB_ID：迁移作业标识符。
    • REGION：您要保存迁移作业的区域。
    • SOURCE_CONN_ID：源连接配置文件标识符。
    • DEST_CONN_ID：目标连接配置文件的标识符。
    • DATABASES_LIST：要迁移的数据库的英文逗号分隔列表。

  7. 启动迁移作业。
    启动迁移作业以开始复制流程：

    gcloud database-migration migration-jobs start MIGRATION_JOB_ID \
  --region=REGION

    替换以下内容：

    • MIGRATION_JOB_ID：迁移作业的标识符。
    • REGION：迁移作业所在的区域。

完成迁移

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

  1. 停止对源数据库的所有写入操作。您可以将它们切换到只读模式，以保留操作功能。
  2. 提升迁移作业。
  3. 可选：验证迁移数据是否完整。

后续步骤