从自建PostgreSQL全量迁移至RDS PostgreSQL

背景信息

• 本文以有公网IP的自建数据库为例介绍全量数据迁移的配置流程。为保障数据一致性，全量数据迁移期间请勿在自建PostgreSQL数据库中写入新的数据。如果要实现不停机迁移，请参见从自建PostgreSQL（10.1~13版本）增量迁移至RDS PostgreSQL和从自建PostgreSQL（10.0及以下版本）增量迁移至RDS PostgreSQL。
• 自建PostgreSQL全量迁移至RDS PostgreSQL也可以通过使用逻辑备份进行快速恢复，具体操作，请参见使用pg_restore恢复逻辑备份文件数据。

前提条件

• 自建PostgreSQL数据库版本为9.2、9.3、9.4、9.5、9.6、10.x、11、12、13版本。
• RDS PostgreSQL实例的存储空间须大于自建PostgreSQL数据库占用的存储空间。
• 自建PostgreSQL数据库的服务端口已开放至公网。

注意事项

• DTS在执行全量数据迁移时将占用源库和目标库一定的读写资源，可能会导致数据库的负载上升，在数据库性能较差、规格较低或业务量较大的情况下（例如源库有大量慢SQL、存在无主键表或目标库存在死锁等），可能会加重数据库压力，甚至导致数据库服务不可用。因此您需要在执行数据迁移前评估源库和目标库的性能，同时建议您在业务低峰期执行数据迁移（例如源库和目标库的CPU负载在30%以下）。

• 待迁移的数据库名称中间不能包含短划线（-），例如dts-testdata。

• 如果源库中待迁移的表没有主键或唯一约束，且所有字段没有唯一性，可能会导致目标数据库中出现重复数据。

• 一个数据迁移任务只能对一个数据库进行数据迁移，如果有多个数据库需要迁移，则需要为每个数据库创建数据迁移任务。
• 为保障迁移任务的正常进行，目前仅支持RDS PostgreSQL 11进行主备切换，且需设置参数 rds_failover_slot_mode为sync，设置方式，请参见逻辑复制槽故障转移（Logical Replication Slot Failover）。
  警告 自建PostgreSQL和其他版本的RDS PostgreSQL进行主备切换，会导致迁移中断。
• 对于迁移失败的任务，DTS会触发自动恢复。当您需要将业务切换至目标实例，请务必先终止或释放该任务，避免该任务被自动恢复后，导致源端数据覆盖目标实例的数据。
• 若源库有长事务，且实例包含增量迁移任务，则可能会导致源库长事务提交前的预写日志WAL（Write-Ahead Logging）无法清理而堆积，从而造成源库磁盘空间不足。

迁移类型说明

• 结构迁移

  DTS将迁移对象的结构定义迁移到目标实例，目前DTS支持结构迁移的对象为table、trigger、view、sequence、function、user defined type、rule、domain、operation、aggregate。

• 全量数据迁移

  DTS会将自建PostgreSQL数据库迁移对象的存量数据，全部迁移到目标RDS PostgreSQL数据库中。

费用说明

数据库账号的权限要求

数据库账号创建及授权方法：

• 自建PostgreSQL数据库请参见CREATE USER和GRANT语法。
• RDS PostgreSQL实例请参见创建账号。

全量数据迁移流程

为解决对象间的依赖，提高迁移成功率，DTS对PostgreSQL结构和数据的迁移流程如下：

1. 进行Table、view、sequence、function、user defined type、rule、domain、operation、aggregate的结构迁移。
   说明 不支持迁移插件、使用C语言编写的function。
2. 进行全量数据迁移。
3. 进行trigger、foreign key的结构迁移。

迁移前准备工作

根据待迁移对象所属的数据库和schema信息，在目标RDS PostgreSQL中创建相应数据库和schema（schema名称须一致），详情请参见创建数据库和schema管理。

操作步骤

1. 登录数据传输控制台。

   说明

   若数据传输控制台自动跳转至数据管理DMS控制台，您可以在右下角的中单击，返回至旧版数据传输控制台。

2. 在左侧导航栏，单击数据迁移。

3. 在迁移任务列表页面顶部，选择迁移的目标实例所属地域。

4. 单击页面右上角的创建迁移任务。

5. 配置迁移任务的源库及目标库信息。

   类别	配置	说明
   无	任务名称	DTS会自动生成一个任务名称，建议配置具有业务意义的名称（无唯一性要求），便于后续识别。
   源库信息	实例类型	根据源库的部署位置进行选择，本文以有公网IP的自建数据库为例介绍配置流程。 说明 当自建数据库为其他实例类型时，您还需要执行相应的准备工作，详情请参见准备工作概览。
   	实例地区	当实例类型选择为有公网IP的自建数据库时，实例地区无需设置。 说明 如果您的自建PostgreSQL数据库进行了白名单安全设置，您需要在实例地区配置项后，单击获取DTS IP段来获取到DTS服务器的IP地址，并将获取到的IP地址加入自建PostgreSQL数据库的白名单安全设置中。
   	数据库类型	选择PostgreSQL。
   	主机名或IP地址	填入自建PostgreSQL数据库的访问地址，本案例中填入公网地址。
   	端口	填入自建PostgreSQL数据库的服务端口，默认为5432。
   	数据库名称	填入自建PostgreSQL数据库中待迁移的数据库名。
   	数据库账号	填入自建PostgreSQL的数据库账号，权限要求请参见数据库账号的权限要求。
   	数据库密码	填入该数据库账号对应的密码。 说明 源库信息填写完毕后，您可以单击数据库密码后的测试连接来验证填入的源库信息是否正确。源库信息填写正确则提示测试通过；如果提示测试失败，单击测试失败后的诊断，根据提示调整填写的源库信息。
   目标库信息	实例类型	选择RDS实例。
   	实例地区	选择目标RDS实例所属地域。
   	RDS实例ID	选择目标RDS实例ID。
   	数据库名称	填入RDS实例中待迁入数据的数据库名，可以和自建PostgreSQL中待迁移的数据库名不同。 说明 您需要先在RDS实例中创建相应的数据库和schema，详情请参见迁移前准备工作。
   	数据库账号	填入目标RDS实例的数据库账号，权限要求请参见数据库账号的权限要求。
   	数据库密码	填入该数据库账号对应的密码。 说明 目标库信息填写完毕后，您可以单击数据库密码后的测试连接来验证填入的目标库信息是否正确。目标库信息填写正确则提示测试通过；如果提示测试失败，单击测试失败后的诊断，根据提示调整填写的目标库信息。

6. 配置完成后，单击页面右下角的授权白名单并进入下一步。

   如果源或目标数据库是阿里云数据库实例（例如RDS MySQL、云数据库MongoDB版等），DTS会自动将对应地区DTS服务的IP地址添加到阿里云数据库实例的白名单；如果源或目标数据库是ECS上的自建数据库，DTS会自动将对应地区DTS服务的IP地址添到ECS的安全规则中，您还需确保自建数据库没有限制ECS的访问（若数据库是集群部署在多个ECS实例，您需要手动将DTS服务对应地区的IP地址添到其余每个ECS的安全规则中）；如果源或目标数据库是IDC自建数据库或其他云数据库，则需要您手动添加对应地区DTS服务的IP地址，以允许来自DTS服务器的访问。DTS服务的IP地址，请参见DTS服务器的IP地址段。

   警告

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

7. 选择迁移对象及迁移类型。

   配置	说明
   迁移类型	如果只需要进行全量数据迁移，则同时勾选结构迁移和全量数据迁移。 如果需要进行不停机迁移，则同时勾选结构迁移、全量数据迁移和增量数据迁移。 本案例为全量数据迁移，迁移类型中勾选结构迁移和全量数据迁移。 说明 为保障数据一致性，数据迁移期间请勿在自建PostgreSQL数据库中写入新的数据。
   迁移对象	在迁移对象框中单击待迁移的对象，然后单击将其移动至已选择对象框。 说明 迁移对象选择的粒度为Schema、表、列。 默认情况下，迁移对象在目标库中的名称与源库保持一致。如果您需要改变迁移对象在目标库中的名称，需要使用对象名映射功能，详情请参见库表列映射。 如果使用了对象名映射功能，可能会导致依赖这个对象的其他对象迁移失败。
   映射名称更改	如需更改迁移对象在目标实例中的名称，请使用对象名映射功能，详情请参见库表列映射。
   源、目标库无法连接重试时间	默认重试12小时，您也可以自定义重试时间。如果DTS在设置的时间内重新连接上源、目标库，迁移任务将自动恢复。否则，迁移任务将失败。 说明 由于连接重试期间，DTS将收取任务运行费用，建议您根据业务需要自定义重试时间，或者在源和目标库实例释放后尽快释放DTS实例。

8. 上述配置完成后，单击页面右下角的预检查并启动。

   说明

   • 在迁移任务正式启动之前，会先进行预检查。只有预检查通过后，才能成功启动迁移任务。

   • 如果预检查失败，单击具体检查项后的，查看失败详情。

     • 您可以根据提示修复后重新进行预检查。

     • 如无需修复告警检测项，您也可以选择确认屏蔽、忽略告警项并重新进行预检查，跳过告警检测项重新进行预检查。

9. 预检查通过后，单击下一步。

10. 在购买配置确认页面，选择链路规格并选中数据传输（按量付费）服务条款。

11. 单击购买并启动，迁移任务正式开始。
    说明 请勿手动结束迁移任务，否则可能会导致数据不完整。您只需等待迁移任务完成即可，迁移任务会自动结束。
12. 将业务切换至RDS实例。

后续操作

用于数据迁移的数据库账号拥有读写权限，为保障数据库安全性，请在数据迁移完成后，删除自建PostgreSQL数据库和RDS PostgreSQL实例中的数据库账号。