• 同步库的CONNECT权限。

• 同步模式的USAGE权限。

• 同步表的SELECT权限。

• 同步序列的SELECT权限。

• 系统表pg_catalog.pg_authid的SELECT权限（用于同步用户的密码）。
   

• 同步库的CONNECT权限。

• 同步模式的USAGE权限。

• 同步表的SELECT权限，其中无主键表还需要MAINTAIN、UPDATE、DELETE和TRUNCATE权限（源库版本>=17.0时，如果源库连接账号为pg_maintain的成员，则不需要无主键表的MAINTAIN、UPDATE、DELETE或TRUNCATE权限）。

• 同步序列的SELECT权限。

• 系统表pg_catalog.pg_authid的SELECT权限（用于同步用户的密码）。

• REPLICATION连接权限。

说明

• 无主键表的MAINTAIN、UPDATE、DELETE或TRUNCATE权限，仅用于对无主键表短暂加锁，以确保迁移后，目标库中无主键表数据与源库保持一致。

• REPLICATION连接权限的添加方法：

       a.    在源数据库的“pg_hba.conf”配置文件的所有配置前增加一行配置“host replication <src_user_name> <drs_instance_ip>/32 <认证方式>”；

              认证方式可参考PostgreSQL官方文档pg_hba.conf文件配置，常见的认证方式有scram-sha-256等。

       b.    在源库使用SUPERUSER用户执行语句“select pg_reload_conf();”生效，或重启数据库实例生效。
 

• 库级同步：

−    如果目标库不是postgres，需要具有CREATEDB权限。

−    如果目标库是postgres，需要具有postgres库的CONNECT和CREATE权限、对模式public的USAGE和CREATE权限。

• 表级同步：

−    如果需要同步库，需要具有CREATEDB权限。

−    如果需要同步模式，需要具有模式所在库的CONNECT权限、模式所在库上的CREATE权限。

−    如果需要同步模式下的对象，需要具有模式所在库的CONNECT权限、对象所在模式的USAGE权限、对象所在模式上的CREATE权限。

• 同步用户：需要具有CREATEROLE权限。

• 同步用户权限：同步用户的default privilege需要为系统默认值，否则可能导致目标库与源库的对象权限不一致。

说明

• 同步事件触发器、文本搜索解析器、文本搜索模板时，不仅要求目标库版本为RDS for PostgreSQL 11.11及以上，还要求目标库连接用户为root用户或root用户的成员。

• 目标库版本为PostgreSQL 15时，库级同步及表级同步目标库没有建库的场景下，全量或增量同步的过程中，可能会由于没有模式public的USAGE及CREATE权限而导致同步失败。
  
   

• 全量同步的范围：

−    库级同步支持：模式、表、索引、约束、视图、物化视图、序列、存储过程、规则、触发器、外键、排序规则、插件、编码转换信息、聚合函数、操作符、统计扩展、转换信息、文本搜索配置、函数、数据类型、类型转换、用户、事件触发器、文本搜索解析器、文本搜索模板的同步。

表级同步时，仅支持表、视图、物化视图、序列、用户、普通索引的同步。

−    不支持系统模式（“pg_”开头的任何模式、“information_schema”、“sys”、“utl_raw”、“dbms_lob”、“dbms_output”和“dbms_random”）、系统表、系统用户、表空间、外部数据包装器、外部服务器、用户映射、发布、订阅等其他对象。

• 不支持实例级同步：

−    每次至多同步一个库（database），同步多个库需要使用多个DRS任务

• 不支持设置分区表上的触发器为disable。

• 如果做增量同步：

       源数据库的“pg_hba.conf” 文件中包含如下的配置：

       host replication all 0.0.0.0/0 md5

• 源数据库需提前安装test_decoding插件。

• 源数据库中不可以存在同名的触发器。

通用：

• 请勿修改源库和目标库的端口号，请勿修改、删除源库和目标库连接用户的密码、权限，否则可能导致任务失败。

• 请勿在目标库做写入操作，否则可能导致数据不一致。

• 为保证同步任务正常和数据的一致性，如有以上诉求，建议在业务低峰期时重新创建DRS任务。

全量同步阶段：

• 请勿在源库执行任何DDL，否则可能导致数据不一致或任务失败。

增量同步阶段：

• 请勿修改源数据库表的主键或者唯一键（主键不存在时），否则可能导致增量数据不一致或任务失败。

• 请勿修改源数据库中表的replica identity属性，否则可能导致增量数据不一致或任务失败。

• 库级同步时，源库新增无主键表时，请务必同时将该无主键表的replica identity属性设置为full，然后再写入数据，否则可能导致数据不一致或任务失败。

• 库级同步时，源库新增主键表时，如果主键列toast属性为main、external、extended时，请务必同时将该表的replica identity属性设置为full，然后再写入数据，否则可能导致数据不一致或任务失败。

• 支持部分DML（Data Manipulation Language）：包括INSERT、UPDATE、DELETE。

• 支持部分DDL（Data Define Language）：包括TRUNCATE（仅PostgreSQL 11及以上版本支持）、CREATE SCHEMA、CREATE TABLE、DROP TABLE、ALTER TABLE（包含ADD COLUMN、DROP COLUMN、ALTER COLUMN、RENAME COLUMN、ADD CONSTRAINT、DROP CONSTRAINT、RENAME）、CREATE SEQUENCE、DROP SEQUENCE、ALTER SEQUENCE、CREATE INDEX、ALTER INDEX、DROP INDEX、CREATE VIEW、ALTER VIEW、COMMENT ON COLUMN、COMMENT ON TABLE、COMMENT ON SCHEMA、COMMENT ON SEQUENCE、COMMENT ON INDEX、COMMENT ON VIEW。

       表级同步时，DDL仅支持TRUNCATE（仅PostgreSQL 11及以上版本支持）、DROP TABLE 、ALTER TABLE、COMMENT ON COLUMN、COMMENT ON TABLE，其中ALTER TABLE支持：ADD COLUMN、DROP COLUMN、ALTER COLUMN、RENAME COLUMN、ADD CONSTRAINT、DROP CONSTRAINT、RENAME。

• 不支持：无日志表（UNLOGGED TABLE）的DML，临时表的DML。

说明

• 同步DDL的实现原理：在源库通过事件触发器捕获DDL语句，并且记录在特定的表中，因此需要提前在源库创建事件触发器、函数等。详细操作可参考3.11.7 通过创建表、事件触发器和函数实现PostgreSQL增量DDL同步。

• 增量发送心跳：PostgreSQL 9.6及以上版本，当源库需要同步的数据库长时间（超过10小时）无数据写入时，DRS拉取日志进程会调用pg_logical_emit_message在源库WAL日志中插入心跳信息（只会增加WAL日志，业务无感知），用于保证逻辑复制槽位点正常推进。

同步对比阶段：

• 建议在源库的业务低峰期进行数据比对，防止误报不一致数据，以及减少对源库和DRS任务的冲击。

• 在增量同步过程中做对比时，源库如果存在写入，则对比结果可能不一致。

• 不支持在全量同步过程中做对比。

• 不支持数据对比过程中做限速。

结束任务：

• 任务正常结束：

−    将自动重置目标库序列值（自增序列值为源库序列值+安全余度，自减序列值为源库序列值-安全余度，安全余度默认为10000），若选择了同步用户，任务结束时将自动同步用户的成员关系。

−    全量实时同步任务结束时会对序列值进行比对，序列值采用逻辑一致性的判断原则，即自增序列当且仅当目标库对应序列值大于等于源库对应序列值，自减序列当且仅当目标库对应序列值小于等于源库对应序列值时，序列值判定为一致。

−    全量+增量或增量实时同步任务正常结束时，将自动删除任务在源库创建的流复制槽。

−    实时同步任务正常结束时，如果目标库session_replication_role值为replica，需手动将目标库session_replication_role参数值修改为原来的值。

• 任务强制结束：

−    需要手动刷新目标库中的序列值，可参考PostgreSQL为源强制结束任务章节的指导进行操作。

−    强制结束全量+增量或增量实时同步任务，需要手动删除源库可能残留的复制槽，可参考PostgreSQL为源强制结束任务章节的指导进行操作。

−    强制结束实时同步任务，如果目标库session_replication_role值为replica，需手动将目标库session_replication_role参数值修改为原来的值。

−    逻辑复制槽命名规则为“drs_唯一性标识”，其中唯一性标识需要将任务node id中的“-”替换为“_”获取。node id可在DRS任务查看同步日志页面查看task node id is ***日志找到。

• 目标数据库和源数据库的lc_monetary参数值一致。

• 若要做增量同步，且同步对象包含外键、触发器或事件触发器，则目标数据库的session_replication_role参数必须设置为replica，同步结束后，此参数需改为原来的值。

• 目标数据库不可以包含，与待同步对象类型相同且名称相同的对象，包括库、模式、表等。系统库、系统模式、系统表等除外。

• 支持目标数据库中的表比源数据库多列场景，但是需要避免以下场景可能导致的任务失败。

−    目标数据库多的列要求非空且没有默认值，源库insert数据，同步到目标数据库后多的列为null，不符合目标数据库要求。

−    目标数据库多的列设置固定默认值，且有唯一约束。源库insert多条数据后，同步到目标数据库后多的列为固定默认值，不符合目标数据库要求。

• 模式名或表名映射时，为防止索引和约束名冲突，同步后表上的原索引名称将变为此格式：i_+哈希值+原索引名（可能被截断）+_key。其中哈希值由“原模式名_原表名_原索引名”计算得到。同理，表上的原约束名将变为：c_+哈希值+原约束名（可能被截断）+_key。

• 对于全量+增量和增量任务，启动前请确保源库中未启动长事务，启动长事务会阻塞逻辑复制槽的创建，进而引发任务失败。

• 对于全量+增量和增量任务，如果预校验存在“内部错误”且在任务未启动时结束，请参考PostgreSQL为源强制结束任务章节检查并删除流复制槽，防止源库中流复制槽残留。

• 对于全量+增量和增量任务，任务启动后，仅支持以下版本的源库发生主备倒换：源库为RDS for PostgreSQL 12.6及以上的小版本、RDS for PostgreSQL 13及以上版本的所有小版本。

• 如果选择同步DDL，须注意源库执行DDL时，确保在目标库上是兼容的。

• PostgreSQL->PostgreSQL同步任务默认允许级联拓扑，不允许回环拓扑（即不支持从实例A同步到实例B，再从实例B同步到实例A）。

说明

同步DDL的实现原理是：在源库通过事件触发器捕获DDL语句，并且记录在特定的表中，然后将DDL语句同步至目标库。因此启动任务前，需要提前在源库创建事件触发器、函数等。详细操作可参考通过创建表、事件触发器和函数实现PostgreSQL增量DDL同步。

• 支持同步的对象有如下限制：

−    对象名称：库名不可以包含+"%'\<>，模式名和表名不可以包含".'<>，列名不可以包含"和'。

−    表：不同步临时表。表级同步时，表的约束、索引及规则会一起同步，表的触发器不会同步。

−    模式：仅当目标实例为RDS for PostgreSQL 15及以上版本时，才支持同步 public模式的权限，且在同步过程中将保留目标端已有的权限设置。表级同步时，会同步目标库已存在模式的权限。

−    函数：不同步C语言函数，不同步带有leakproof属性或带有support属性的函数。

−    插件：不同步插件的元数据。

−    数据类型：不同步基本数据类型。

−    BLOB类型：当前DRS不同步BLOB类型。

−    类型转换：不同步二进制强制型的类型转换。

−    事件触发器：受限于目标库版本，仅目标库为RDS for PostgreSQL 11.11及以上版本时支持。

−    文本搜索解析器：受限于目标库版本，仅目标库为RDS for PostgreSQL 11.11及以上版本时支持。

−    文本搜索模板：受限于目标库版本，仅目标库为RDS for PostgreSQL 11.11及以上版本时支持。

−    用户：不同步目标库已存在的用户，不同步用户的superuser属性、replication属性、bypassrls属性，不同步superuser用户的成员关系。对象owner/grantor为superuser用户时，不同步它的owner/grantor。目标库为RDS for PostgreSQL时，要同步用户的密码不能包含用户名。表级同步时，不同步源库用户的默认访问权限。superuser用户同步至目标库后为普通用户，默认授予root权限（仅当目标库版本为RDS for PostgreSQL 11.11及以上时支持）。

此处以“VPC网络”为示例，可选“公网网络”、“VPC网络”和“VPN、专线网络”。

• VPC网络：适合云上同账号同Region同VPC场景下数据库之间的同步。

• 公网网络：适合通过公网网络将其他云下或其他平台的数据库同步到目标数据库的场景，此类型要求数据库绑定弹性公网IP（EIP）。当一端为本云的数据库实例时，DRS任务与该端的通信方式为VPC内网。

• VPN、专线网络：适合VPN、专线、CC、VPCEP、或者用户已打通VPC对等连接的网络场景，实现其他云下自建数据库与云上数据库同步、云上同Region跨账号、或云上跨Region的数据库之间的同步。

请选择同步实例所在的子网。也可以单击“查看子网”，跳转至“网络控制台”查看实例所在子网帮助选择。

默认值为当前所选数据库实例所在子网，请选择有可用IP地址的子网。为确保同步实例创建成功，仅显示已经开启DHCP的子网。

选择迁移实例的IP类型，目前支持选择“IPv4”或“IPv4&IPv6双栈”。

• 只有所选择的VPC及子网都开启了IPv6双栈功能，才能选择IP类型为“IPv4&IPv6双栈”。

• 选择“IPv4&IPv6双栈”时，如果源或者目标数据库是通过选择实例的方式进行连接，DRS会优先通过IPv4地址进行访问。

DRS任务支持的同步模式，此处以“全量+增量”为示例。

• 全量+增量：

该模式为数据持续性实时同步，通过全量过程完成目标端数据库的初始化后，增量同步阶段通过解析日志等技术，将源端和目标端数据保持数据持续一致。

• 全量

该模式为数据库一次性同步，适用于可中断业务的数据库同步场景，全量同步将非系统数据库的全部数据库对象和数据一次性同步至目标端数据库。

• 增量：

增量同步通过解析日志等技术，将源端产生的增量数据同步至目标端。

选择DRS实例的规格类型，不同规格类型对应不同性能的性能上限，详细可参考实时同步链路规格说明。

说明

目前，DRS同步仅支持任务类型为单AZ的同步任务升级实例规格，不支持降低规格，具体操作及约束限制可参考同步规格变更。

可选配置，对同步任务的标识。使用标签可方便管理您的任务。每个任务最多支持20个标签配额。

任务创建成功后，您可以单击任务名称，在“标签”页签下查看对应标签。关于标签的详细操作，请参见标签管理。

流速模式支持限速和不限速，默认为不限速。

• 限速

自定义的最大同步速度，全量同步过程中的同步速度将不会超过该速度。

当流速模式选择了“限速”时，你需要通过流速设置来定时控制同步速度。流速设置通常包括限速时间段和流速大小的设置。默认的限速时间段为“全天限流”，您也可以根据业务需求选择“时段限流”。自定义的时段限流支持最多设置3个定时任务，每个定时任务之间不能存在交叉的时间段，未设定在限速时间段的时间默认为不限速。

流速的大小需要根据业务场景来设置，不能超过9999MB/s。

• 不限速

对同步速度不进行限制，通常会最大化使用源数据库的出口带宽。该流速模式同时会对源数据库造成读消耗，消耗取决于源数据库的出口带宽。比如源数据库的出口带宽为100MB/s，假设高速模式使用了80%带宽，则同步对源数据库将造成80MB/s的读操作IO消耗。

说明

• 限速模式只对全量阶段生效，增量阶段不生效。
• 您也可以在创建任务后修改流速模式。具体方法请参见修改流速模式。

该冲突策略特指增量同步中的冲突处理策略，全量阶段的冲突默认忽略。冲突策略目前支持如下形式：

• 忽略

当同步数据与目标数据库已有数据冲突时（主键/唯一键存在重复等），将跳过冲突数据，继续进行后续同步。

• 报错

当同步数据与目标数据库已有数据冲突时（主键/唯一键存在重复等），同步任务将失败并立即中止。

• 覆盖

当同步数据与目标数据库已有数据冲突时（主键/唯一键存在重复等），将覆盖原来的冲突数据。

当同步数据与目标库已有数据冲突时，选择“忽略”无法保证最终一致性，如需保证数据一致性，可选择“覆盖”策略。

对象同步范围支持选择普通索引、增量DDL同步和全量阶段填充物化视图，您可以根据业务需求选择是否进行同步。

全量阶段填充物化视图：仅对源库已经填充的物化视图生效，该填充操作会影响全量同步性能，建议在全量同步完成后，手动在目标库填充。

选择需要同步的DML操作，默认都勾选。

不勾选Delete则不会同步源库增量数据中的Delete语句，可能会导致数据不一致，因此存在数据冲突或任务失败的风险。

左侧框是源数据库对象，右侧框是已经选择的对象，同步对象支持表级同步、库级同步，您可以根据业务场景选择对应的数据进行同步。

• 选择库级同步：全量同步时，同步对象为所选的库、库中对象的存量数据；增量同步时，同步除了无日志表、临时表外的所有表的DML及部分DDL。
• 选择表级同步：全量同步时，同步对象为所选的表、序列、视图或物化视图的存量数据；增量同步时，同步所选表的DML及部分DDL。
• 在同步对象右侧已选对象框中，可以使用对象名映射功能进行源数据库和目标数据库中的同步对象映射，具体操作可参考对象名映射。

       模式名或表名映射时，为防止索引和约束名冲突，同步后表上的原索引名称将变为此格式：i_+哈希值+原索引名（可能被截断）+_key。其中哈希值由“原模式名_原表名_原索引名”计算得到。同理，同步后表上的原约束名将变为：c_+哈希值+原约束名（可能被截断）+_key。

说明

• 选择对象的时候支持对展开的库进行搜索，以便您快速选择需要的数据库对象。
• 如果有切换源数据库的操作或源库同步对象变化的情况，请在选择同步对象前单击右上角的，以确保待选择的对象为最新源数据库对象。
• 当对象名称包含空格时，名称前后的空格不显示，中间如有多个空格只显示一个空格。
• 选择的同步对象名称中不能包含空格。

账号是否支持同步。

一般分为两类：可同步的账号和不支持同步的账号。对于不支持同步的账号，在备注列的查看详情中会提示具体的原因。

• 全量同步需要具备如下权限：

       数据库的CONNECT权限，模式的USAGE权限，表的SELECT权限，序列的SELECT权限，系统表pg_catalog.pg_authid的select权限（用于同步用户的密码）。

• 全量+增量、增量同步需要具备如下权限：

       数据库的CONNECT权限，模式的USAGE权限，表的SELECT权限，序列的SELECT权限，系统表pg_catalog.pg_authid的SELECT权限（用于同步用户的密码），无主键表的UPDATE、DELETE和TRUNCATE权限，REPLICATION连接权限。

• 库级同步：

−    如果目标库不是postgres，需要具有CREATEDB权限。

−    如果目标库是postgres，需要具有postgres库的CONNECT和CREATE权限、对模式public的USAGE和CREATE权限。

• 表级同步：

−    如果需要同步库，需要具有CREATEDB权限。

−    如果需要同步模式，需要具有模式所在库的CONNECT权限、模式所在库上的CREATE权限。

−    如果需要同步模式下的对象，需要具有模式所在库的CONNECT权限、对象所在模式的USAGE权限、对象所在模式上的CREATE权限。

• 同步用户：需要具有CREATEROLE权限。

• 同步用户权限：同步用户的default privilege需要为系统默认值，否则可能导致目标库与源库的对象权限不一致。
   

• 同步对象中是如果存在包含bytea、text类型字段的表，建议创建大规格及以上规格的DRS任务进行同步，否则可能会导致OOM。

• 支持的字段类型有：数字类型、货币类型、字符类型、二进制数据类型、日期/时间类型、布尔类型、枚举类型、几何类型、网络地址类型、位串类型、文本搜索类型、UUID类型、XML类型、JSON类型、数组、复合类型、范围类型。

• 支持库表级同步。

• 不支持实例级同步。

• 不支持系统模式（“pg_”开头的任何模式、“information_schema”、“sys”、“utl_raw”、“dbms_lob”、“dbms_output”和“dbms_random”）、系统表、系统用户、表空间、外部数据包装器、外部服务器、用户映射、发布、订阅等其他对象。

• 库名不能包含+"%'\<>。

• 模式名和表名不能包含".'<>。

• 列名不能包含"和'。

• 全量+增量实时同步任务，源数据库不能为备机。

• 全量实时同步任务，源数据库可以为备机，但是hot_standby_feedback参数必须为on。