方案概述

性能开销：数据同步会增加源集群的读负载，建议在业务低峰期执行升级操作。

WAL日志要求：

• 源集群的wal_level参数值需为logical。

• 为确保数据同步任务的稳定，建议在全量同步阶段将WAL日志保留时间设置为7天以上，增量同步阶段设置为24小时以上。WAL日志保留时间不足可能导致任务失败，极端情况下甚至可能会导致数据不一致或丢失。

• 长时间未提交的事务（长事务）可能会导致WAL日志堆积，占用大量存储空间。请在升级前关注并处理源集群的长事务。

临时对象创建：

• DTS会在源集群的public schema下创建若干临时表（如public.dts_pg_class、public.dts_pg_attribute、public.dts_pg_type、public.dts_pg_enum、public.dts_postgres_heartbeat、public.dts_ddl_command、public.dts_args_session等），用于同步数据和记录心跳信息。在同步期间，请勿删除源库中的临时表，否则会导致DTS任务异常。临时表会在DTS实例释放后自动删除。

• DTS会在源集群创建名前缀为dts_sync_的复制槽（Replication Slot）。DTS会每隔120分钟自动清理一次历史复制槽，避免其持续累积占用磁盘空间。

  说明

  • DTS释放实例后会主动删除该复制槽，如果您在同步期间修改了数据库密码，或者删除了DTS的访问IP白名单，则会导致该复制槽无法自动删除，此时需要您在源库中手动删除，避免其持续累积占用磁盘空间导致源集群不可用。

  • 当释放同步任务或同步失败时，DTS会主动清理该复制槽。如果源集群发生了主备切换，则需要您登录备库来手动清理，以防WAL日志持续堆积。

• 请勿手动删除这些临时表和复制槽，否则将导致升级任务失败。任务结束后，系统会自动清理这些对象。

升级期间的禁止操作：

• 禁止对源集群执行参数设置操作。

• 禁止变更源集群的可用区或连接地址。

• 大版本升级期间，系统将在目标PolarDB集群自动创建一个格式为dts_clone%的迁移账号，密码随机生成。升级期间，请勿修改账号密码或删除账号，否则将导致DTS同步失败。完成迁移后您可以按需修改账号密码或者删除账号。

• 禁止通过DTS以外的任何方式向目标集群写入数据，否则将导致数据不一致。

  说明

  如果除DTS以外的数据没有写入目标库，您可以使用数据管理DMS（Data Management）来执行在线DDL变更，请参见通过无锁变更工单实现无锁结构变更。

功能与对象限制：

• 不支持跨地域升级。

• 待同步的表需具有主键或唯一约束，否则可能导致数据重复。

• DTS仅校验数据内容，不校验Sequence等数据库对象的元数据。

• 暂不支持全球数据库网络（GDN）中的集群进行大版本升级。

• 如果在待同步的Schema中创建了新的表或使用RENAME命令重建了待同步的表，您需要在对该表写入数据前执行ALTER TABLE schema.table REPLICA IDENTITY FULL;命令，以保障该表数据同步的一致性。执行该命令期间，建议您不要有锁表操作，否则会导致表锁死。建议您在业务低峰期进行操作。

DDL操作限制：仅支持同步部分DDL操作：

手动更新Sequence：DTS不会同步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;
$$;

目标集群空间：由于全量数据写入时会产生表碎片，升级后目标集群的表空间占用会比源集群更大，这属于正常现象。