RDS PostgreSQL实例间的迁移

更新时间：2025-08-21

本文主要介绍云数据库 RDS PostgreSQL 实例之间的数据迁移。

前提条件

已创建源端和目标端 RDS PostgreSQL 实例。创建方式，请参见创建 PostgreSQL 实例。
目标端 RDS PostgreSQL 实例的存储空间须大于源端 RDS PostgreSQL 实例占用的存储空间。

限制说明

类型	说明
源端限制	待同步的表需具备主键或唯一约束，且字段具有唯一性，否则可能会导致目标数据库中出现重复数据。如同步对象为表级别，单次同步任务支持的表数量有限，当超出数量限制，任务提交后会显示请求报错，此时建议您拆分待同步的表，分批配置多个任务，或者配置整库的同步任务。 DTS 不支持迁移源库中的临时表、系统内部的触发器、函数、视图、拓展。待迁移的数据库名称中间不能包含短划线（-），例如 dts-testdata。如需进行增量迁移，WAL日志：需开启，即设置 wal_level 参数的值为 logical。如为增量迁移任务，DTS 要求源数据库的 WAL 日志保存 24 小时以上，如为全量迁移和增量迁移任务，DTS 要求源数据库的 WAL 日志至少保留 7 天以上（您可在全量迁移完成后将 WAL 日志保存时间设置为 24 小时以上），否则 DTS 可能因无法获取 WAL 日志而导致任务失败，极端情况下甚至可能会导致数据不一致或丢失。在库表结构同步和全量同步阶段，请勿执行库或表结构变更的 DDL 操作，否则会导致数据同步任务失败。若源库有长事务，且实例包含增量迁移任务，则可能会导致源库长事务提交前的预写日志 WAL（Write-Ahead Logging）无法清理而堆积，从而造成源库磁盘空间不足。当源端实例发生主备切换时，由于 PostgreSQL 自身限制，新的主库并不会保留原主库的复制槽，因此需重新创建包含全量阶段和增量阶段的 DTS 任务。
其他限制	一个 DTS 任务只能对一个数据库进行数据迁移，如果有多个数据库需要迁移，则需要为每个数据库创建数据迁移任务。不支持包含时区类型列的时间戳。复制多个同名但名称具有不同大小写的表（例如，table1、TABLE1 和 Table1）会导致无法预测的行为。全量迁移会并发执行 INSERT 操作，导致目标数据库的表产生碎片，因此全量迁移完成后目标实例的表空间比源实例的表空间大。
特殊情况	当目标库为 RDS PostgreSQL 时：不支持 RDS 代理实例，仅支持主实例 PostgreSQL 14、15 版本默认密码加密算法不一样，需要调整后才能正常迁移，步骤如下：修改参数 password_encryption = 'md5'。重启 PostgreSQL 数据库。

支持的SQL操作

操作类型	SQL操作语句
DML	INSERT、UPDATE、DELETE

数据库账号权限要求

数据库	结构迁移	全量迁移	增量迁移
源端	pg_catalog 的 usage 权限	迁移对象的 select 权限	superuser
目标端	迁移对象的 create、usage 权限	schema 的 owner 权限	schema 的 owner 权限

准备工作

PostgreSQL 的 pg_hba.conf 配置文件控制客户端身份验证。文件通常存储在数据库集群的数据目录中。

安装逻辑流复制插件

登录自建 PostgreSQL 所属的服务器，下载 wal2json 逻辑流复制插件，下载地址如下： https://github.com/eulerto/wal2json 按照官方指导安装 wal2json 插件。
修改 PostgreSQL postgresql.conf 配置文件中的如下参数：
1. 将 max_replication_slots 设置为大于 1 的整数，max_replication_slots 的值应根据您需要同时运行的任务数进行设置。例如，要同时运行十二个任务，您需要设置至少十二个 slot。
示例：max_replication_slots = 12
1. 将 wal_level 设置为 logical，开启 wal 逻辑日志。
示例：wal_level = logical
1. 将 wal_sender_timeout 设置为 0，复制连接处于不活跃状态的时间超过 wal_sender_timeout 时，会被源端库终止。该参数的默认值为 60 秒，但我们建议您将该参数设置为零，这样会禁用超时机制。
示例：wal_sender_timeout = 0
1. 将 max_wal_senders 设置为大于 10 的整数，max_wal_senders 参数用于设置可以运行的并发任务数，建议和 max_replication_slots 设置的值一致。
示例：max_wal_senders = 12
重启 PostgreSQL 数据库
将要迁移表的 replica identity 设置为 FULL
SQL
```
1ALTER TABLE TABLENAME REPLICA IDENTITY FULL;
```

操作步骤

登录 DTS 控制台。
点击 创建数据传输任务 进入 DTS 创建任务页面，详情参见购买流程。
创建任务成功后自动返回任务列表页面，选择新创建的任务，点击 更多操作—>配置任务。

在配置任务页面，配置源库及目标库信息，本文以公网接入方式为例介绍配置流程。

配置流程

类别	配置	说明
任务基本属性	任务名称	DTS 会自动生成一个任务名称，建议配置具有业务意义的名称（无唯一性要求），便于后续识别。
源端连接设置	实例 ID	选择源 RDS PostgreSQL 实例 ID。
源端连接设置	数据库	选择默认连接的数据库。
目标端连接设置	实例 ID	选择目标 RDS PostgreSQL 实例 ID。
目标端连接设置	数据库	选择默认连接的数据库。

配置完成后，点击页面下方的 授权白名单进入下一步。

如果您主动为 RDS PostgreSQL 关联了自定义的 VPC 安全组规则，则需要您手动添加对应地区 DTS 服务的 IP 地址，以允许来自 DTS 服务器的访问，操作步骤请参见为您的 VPC 安全组添加 DTS 网段的放行规则。

警告：

DTS 自动添加或您手动添加 DTS 服务的 IP 地址段可能会存在安全风险，一旦使用本产品代表您已理解和确认其中可能存在的安全风险，并且需要您做好基本的安全防护，包括但不限于加强账号密码强度防范、限制各网段开放的端口号、内部各 API 使用鉴权方式通信、定期检查并限制不需要的网段等等。

配置任务对象映射。

配置	说明
迁移类型	根据需求及各引擎对迁移类型的支持情况，选择迁移类型。
限制传输速度	根据实际情况，选择是否对全量迁移和增量同步任务进行更细粒度的限流策略设置（设置每秒迁移的行数和每秒迁移的数据量），以缓解目标库压力。详情参见：迁移限速。
传输对象	手动选择：选择此选项时，在页面左侧选择需要迁移的库表，库表信息将会被自动添加到页面右侧。模式匹配：详情参见：模式匹配。

上述配置完成后，点击页面下方的 保存并预检查。
说明
- 在迁移任务正式启动之前，会先进行预检查。只有预检查通过后，才能成功启动迁移任务。
- 如果预检查失败，请查看失败检查项的提示，并根据提示修复后重新进行预检查。
- 如果预检查产生警告：
  - 对于不可以忽略的检查项，请查看失败检查项的提示，并根据提示修复后重新进行预检查。
  - 对于可以忽略无需修复的检查项，您可以点击 强制通过，在弹出的窗口中勾选风险确认信息并点击确定，跳过告警检查项重新进行预检查。如果选择屏蔽告警检查项，可能会导致数据不一致等问题，给业务带来风险。
前置校验提示校验成功后，点击 立即开启任务。
迁移任务正式开始，您可以在任务列表页面查看具体进度。