从自建PostgreSQL（10.0及以下版本）增量迁移至RDS PostgreSQL

前提条件

• 自建PostgreSQL数据库版本为9.4.8及以上、9.5、9.6或10.0版本。
• RDS PostgreSQL实例的存储空间须大于自建PostgreSQL数据库占用的存储空间。
• 自建PostgreSQL数据库的服务端口已开放至公网。

注意事项

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

• 在增量数据迁移过程中，如果迁移对象的选择粒度为Schema，在待迁移的Schema中创建了新的表或使用RENAME命令重建了待迁移的表，您需要在对该表写入数据前执行ALTER TABLE schema.table REPLICA IDENTITY FULL;命令。
  说明 将上述命令中的schema和table替换成真实的Schema名和表名。

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

• 对于迁移失败的任务，DTS会触发自动恢复。当您需要将业务切换至目标实例，请务必先终止或释放该任务，避免该任务被自动恢复后，导致源端数据覆盖目标实例的数据。
• 若源库有长事务，且实例包含增量迁移任务，则可能会导致源库长事务提交前的预写日志WAL（Write-Ahead Logging）无法清理而堆积，从而造成源库磁盘空间不足。

迁移限制

• 一个数据迁移任务只能对一个数据库进行数据迁移，如果有多个数据库需要迁移，则需要为每个数据库创建数据迁移任务。
• 待迁移的数据库名称中间不能包含短划线（-），例如dts-testdata。
• 如果迁移过程中源库发生了主备切换，DTS的增量数据迁移无法实现断点续传。
• 由于源库的主备节点可能存在同步延迟导致数据不一致，执行数据迁移时请使用源库的主节点作为迁移的数据源。
  说明 为避免数据迁移对业务的影响，请在业务低峰期执行数据迁移，您还可以根据源库的读写压力情况调整迁移速率，详情请参见调整全量迁移速率。
• DTS的校验对象为数据内容，暂不支持Sequence等元数据的校验，您需要自行校验。
• 由于业务切换到目标端后，新写入的Sequence不会按照源库的Sequence最大值作为初始值去递增，您需要在业务切换前，在源库中查询对应Sequence的最大值，然后在目标库中将其作为对应Sequence的初始值。查询源库Sequence值的相关命令如下：

  do language plpgsql $$
  declare
    nsp name;
    rel name;
    val int8;
  begin
    for nsp,rel in select nspname,relname from pg_class t2 , pg_namespace t3 where t2.relnamespace=t3.oid and t2.relkind='S'
    loop
      execute format($_$select last_value from %I.%I$_$, nsp, rel) into val;
      raise notice '%',
      format($_$select setval('%I.%I'::regclass, %s);$_$, nsp, rel, val+1);
    end loop;
  end;
  $$;

• 为保障迁移任务的正常进行，目前仅支持RDS PostgreSQL 11进行主备切换，且需设置参数 rds_failover_slot_mode为sync，设置方式，请参见逻辑复制槽故障转移（Logical Replication Slot Failover）。
  警告 自建PostgreSQL和其他版本的RDS PostgreSQL进行主备切换，会导致迁移中断。

费用说明

数据库账号的权限要求

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

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

数据迁移流程说明

为解决对象间的依赖，提高迁移成功率，DTS对PostgreSQL结构及数据的迁移顺序如下表所示。

准备工作

1. 可选：下载PostgreSQL源码并完成编译安装。
   说明 若自建PostgreSQL是通过源码安装部署，则无需执行此操作。
   1. 根据源自建PostgreSQL的版本，从PostgreSQL官网下载对应版本的源码。
   2. 依次执行如下命令，配置、编译并安装源码。

      sudo ./configure --prefix=/usr/local/postgresql
      
      sudo make
      
      sudo make install

      重要

      • prefix参数值不能与自建PostgreSQL的安装路径相同。
      • 编译安装PostgreSQL时，PostgreSQL的操作系统版本需与GCC（GNU编译器套件）版本保持一致。
      • 如执行sudo ./configure遇到报错，您可以根据报错提示调整命令。例如，报错信息为readline library not found. Use --without-readline to disable readline support.，则您可以调整命令为sudo ./configure --without-readline.
      • 如您选择其他方式安装PostgreSQL，需要在系统版本以及GCC版本相同的测试环境下，编译ali_decoding。
2. 利用PostgreSQL源码编译生成新ali_decoding文件，替换源自建PostgreSQL中的旧ali_decoding文件。
   1. 下载DTS提供的ali_decoding。
      说明 您也可以在在Linux系统中分别执行如下命令，下载并解压ali_decoding插件。

      sudo wget https://github.com/aliyun/rds_dbsync/archive/refs/heads/master.zip
      unzip master.zip

   2. 执行如下命令，将ali_decoding整个目录拷贝至PostgreSQL（已完成编译安装）的contrib目录中。

      sudo cp rds_dbsync-master/ali_decoding /tmp/postgresql-9.4.26/contrib/ -r

      说明 /tmp/postgresql-9.4.26/contrib/需要替换为PostgreSQL源码对应的目录。
      
   3. 进入ali_decoding目录，将Makefile文件的内容替换为如下：

      # contrib/ali_decoding/Makefile
      MODULE_big = ali_decoding
      MODULES = ali_decoding
      OBJS    = ali_decoding.o
      
      DATA = ali_decoding--0.0.1.sql ali_decoding--unpackaged--0.0.1.sql
      
      EXTENSION = ali_decoding
      
      NAME = ali_decoding
      
      #subdir = contrib/ali_decoding
      #top_builddir = ../..
      #include $(top_builddir)/src/Makefile.global
      #include $(top_srcdir)/contrib/contrib-global.mk
      
      #PG_CONFIG = /usr/pgsql-9.6/bin/pg_config
      #pgsql_lib_dir := $(shell $(PG_CONFIG) --libdir)
      #PGXS := $(shell $(PG_CONFIG) --pgxs)
      #include $(PGXS)
      
      # 源码安装用以下
      ifdef USE_PGXS
      PG_CONFIG = pg_config
      PGXS := $(shell $(PG_CONFIG) --pgxs)
      include $(PGXS)
      else
      subdir = contrib/ali_decoding
      top_builddir = ../..
      include $(top_builddir)/src/Makefile.global
      include $(top_srcdir)/contrib/contrib-global.mk
      endif

   4. 可选：若自建PostgreSQL的版本为9.4（9.4.8~9.4.26），您需要修改ali_decoding.c文件中的set_config_option函数（删掉false参数），修改后的函数如下所示：

          if (extra_float_digits < 3)
              (void) set_config_option("extra_float_digits", "3",
                      PGC_USERSET, PGC_S_SESSION,
                      GUC_ACTION_SAVE, true, 0);

   5. 进入ali_decoding目录，依次执行命令sudo make和sudo make install，编译ali_decoding，并生成安装ali_decoding所需的文件。
   6. 将生成的ali_decoding文件复制到源自建PostgreSQL中，替换源自建PostgreSQL的如下路径中的ali_decoding文件。
      说明 如下路径中的/usr/local/postgresql需要替换为源自建PostgreSQL的安装路径。

      /usr/local/postgresql/lib/ali_decoding.so
      /usr/local/postgresql/share/extension/ali_decoding.control 
      /usr/local/postgresql/share/extension/ali_decoding--0.0.1.sql 
      /usr/local/postgresql/share/extension/ali_decoding--unpackaged--0.0.1.sql

3. 根据待迁移对象所属的数据库和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、表、列。 默认情况下，迁移完成后，迁移对象名跟自建PostgreSQL数据库一致。如果您需要迁移对象在目标RDS实例上名称不同，那么需要使用DTS提供的对象名映射功能。使用方法请参见库表列映射。 如果使用了对象名映射功能，可能会导致依赖这个对象的其他对象迁移失败。
   映射名称更改	如需更改迁移对象在目标实例中的名称，请使用对象名映射功能，详情请参见库表列映射。
   源、目标库无法连接重试时间	默认重试12小时，您也可以自定义重试时间。如果DTS在设置的时间内重新连接上源、目标库，迁移任务将自动恢复。否则，迁移任务将失败。 说明 由于连接重试期间，DTS将收取任务运行费用，建议您根据业务需要自定义重试时间，或者在源和目标库实例释放后尽快释放DTS实例。

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

   说明

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

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

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

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

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

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

11. 单击购买并启动，迁移任务正式开始。

    • 全量数据迁移

      请勿手动结束迁移任务，否则可能导致数据不完整。您只需等待迁移任务完成即可，迁移任务会自动结束。

    • 增量数据迁移

      迁移任务不会自动结束，您需要手动结束迁移任务。

      说明

      请选择合适的时间手动结束迁移任务，例如业务低峰期或准备将业务切换至目标实例时。

      1. 观察迁移任务的进度变更为增量迁移，并显示为无延迟时，将源库停写几分钟，此时增量迁移可能会显示延迟的时间。

      2. 等待迁移任务的增量迁移再次进入无延迟后，手动结束迁移任务。

12. 将业务切换至RDS实例。

后续操作

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