支持的源和目标数据库
表1 支持的数据库
源数据库
目标数据库
GaussDB分布式(ORA兼容模式。版本数据库内核版本为505.2及以下版本,内核版本与数据库引擎版本的关系请参考云数据库GaussDB的数据库引擎版本说明。)
- 本地自建Oracle数据库11g、19c
- ECS自建Oracle数据库11g、19c
支持的同步对象范围
在使用DRS进行同步时,不同类型的同步任务,支持的同步对象范围不同,详细情况可参考表2。DRS会根据用户选择,在“预检查”阶段对同步对象进行自动检查。
表2 支持的同步对象
类型名称
同步范围
同步范围须知
- 不支持实例级同步:不支持实例级别同步,每次至多同步一个库(database),同步多个库需要使用多个DRS任务。
- 支持场景:支持全量同步、增量同步、全量+增量同步。
- **支持的字段:**INTEGER,TINYINT,SMALLINT,BIGINT,TINYINT UNSIGNED,SMALLINT UNSIGNED,INTEGER UNSIGNED,BIGINT UNSIGNED,NUMBER,NUMERIC,REAL,DOUBLE PRECISION,CHARACTER,CHARACTER VARYING,NVARCHAR2,BIT,BIT VARYING,BLOB,BYTEA,CLOB,RAW,TEXT,BOOLEAN,DATE,SMALLDATETIME,TIME WITH TIME ZONE,TIME WITHOUT TIME ZONE,TIMESTAMP WITH TIME ZONE,TIMESTAMP WITHOUT TIME ZONE,MONEY。
- 支持表级同步或导入对象文件:
- 全量同步过程仅支持同步选中表的数据。
- 增量同步过程仅支持同步选中表的DML。
- 不支持同步没有schema的database。
- 不支持同步没有表的schema。
- 不支持同步列存表、压缩表、延迟表、临时表、含生成列的表,多任务模式全量不支持使用TO GROUP或TO NODE方式创建的表,增量不建议同步非日志表。
- 不支持同步系统schema(pg_toast、cstore、snapshot、sys、dbms_job、dbms_perf、pg_catalog、information_schema、utl_file、dbms_output、dbms_random、utl_raw、dbms_sql、dbms_lob、dbe_perf、pkg_service、pkg_util、dbe_file、dbe_random、dbe_output、dbe_raw、dbe_sql、dbe_lob、dbe_task、blockchain、db4ai、dbe_pldebugger、sqladvisor、dbe_application_info、dbe_match、dbe_pldeveloper、dbe_scheduler、dbe_session、dbe_utility、dbe_sql_util、dbe_xml、dbe_xmldom、dbe_xmlparser、dbe_compression、dbe_heat_map、dbe_ilm、dbe_ilm_admin、prvt_ilm、dbe_profiler、dbe_stats、rdsBackup、rdsMetric、rdsRepl)。
- 不支持同步系统表(public schema下的redis_progress_detail、redis_status、pgxc_redsitb、redis_progress)。
- 暂不支持同步序列值,如果同步的表中存在关联的序列,可以在任务结束后按照GaussDB分布式版为源任务序列值同步中内容,手动同步序列值。
- 库名、schema名和表名不可以包含/<.>\\'`|\?和!。列名不可以包含"'和.。
- 使用导入对象文件选表的方式时,要保证导入的表在源库存在或对同步用户可见。
数据库用户权限要求
在使用DRS进行同步时,连接源库和目标库的数据库用户需要满足以下权限要求,才能启动实时同步任务。不同类型的同步任务,需要的用户权限也不同,详细可参考表3进行赋权。DRS会在“预检查”阶段对数据库用户权限进行自动检查,并给出处理建议。
说明:
- 建议创建单独用于DRS任务连接的数据库用户,避免因为数据库用户密码修改,导致的任务连接失败。
- 连接源或目标数据库的用户密码修改后,请尽快修改DRS任务中的连接信息,避免任务连接失败后自动重试,导致数据库用户被锁定影响使用。
- 由于分布式数据库为源链路需要检查每个DN的连通性,建议使用非root数据库用户进行同步,避免因为密码填写错误在连接DN过程中导致用户被锁定。
表3 数据库用户权限
类型名称
全量同步
增量同步
全量+增量同步
源数据库连接用户
用户具备sysadmin角色或以下最小权限:
- DATABASE的CONNECT权限、SCHEMA的USAGE权限、表的SELECT或UPDATE权限(无主键表锁表需要UPDATE权限)、SEQUENCE的SELECT权限。
- 需要具备远程连接权限,添加方法可参考GaussDB远程连接配置方法。
用户具备sysadmin角色或以下最小权限:
- REPLICATION权限或继承了内置角色gs_role_replication的权限、DATABASE的CONNECT权限、SCHEMA的USAGE权限、表的SELECT权限。
- 需要具备远程连接权限,添加方法可参考GaussDB远程连接配置方法。
- 需要保证安全组和防火墙策略放开对应连接端口,详细说明可参考GaussDB为源链路增量同步连接及端口说明。
用户具备sysadmin角色或以下最小权限:
- REPLICATION权限或继承了内置角色gs_role_replication的权限、DATABASE的CONNECT权限、SCHEMA的USAGE权限、表的SELECT或UPDATE权限(无主键表锁表需要UPDATE权限)、SEQUENCE的SELECT权限。
- 需要具备远程连接权限,添加方法可参考GaussDB远程连接配置方法。
- 需要保证安全组和防火墙策略放开对应连接端口,详细说明可参考GaussDB为源链路增量同步连接及端口说明。
目标数据库连接用户
用户需要具备DBA角色或者以下最小权限:
CREATE SESSION权限,表的SELECT、INSERT权限,或者具备RESOURCE角色。
用户需要具备DBA角色或者以下最小权限:
CREATE SESSION权限,表的SELECT、INSERT、UPDATE、DELETE权限,或者具备RESOURCE角色
用户需要具备DBA角色或者以下最小权限:
CREATE SESSION权限,表的SELECT、INSERT、UPDATE、DELETE权限,或者具备RESOURCE角色。
使用须知
DRS全量+增量同步过程一般包含四个阶段:任务启动阶段、全量阶段、增量阶段、结束任务阶段(单全量、单增量任务则包含三个阶段)。为了确保同步各个阶段的平顺,在创建同步任务前,请务必阅读以下使用须知。
表4 使用须知
类型名称
使用和操作限制
任务启动前须知
-
源数据库参数要求:
若选择增量或全量+增量同步时:
- 源库的wal_level参数设置为logical。
- 源库的enable_slot_log参数设置为on。
- 源库的max_replication_slots参数值必须大于当前已使用的复制槽数量。
- 建议对无主键表追加主键,或将无主键表的REPLICA IDENTITY属性设置为FULL。
-
源数据库对象要求:
- 源库要同步的库名、schema名和表名不可以包含/<.>\\'`|\?和!。
-
目标数据库参数要求:
- 目前支持源库为UTF8字符集,目标库为AL32UTF8、UTF8字符集;当源库为GBK或GB18030或ZHS16GBK字符集,目标库为ZHS16GBK、ZHS16CGB231280、ZHS32GB18030字符集时,由于数据库差异,可能存在部分字符不兼容,导致部分数据乱码、数据同步不一致或目标库写入失败等问题。
-
目标数据库对象要求:
-
同步前保证目标库已创建好对应的表结构,且与源端一致;如果进行了列加工,请保证跟列加工后的表结构保持一致。
-
目标库已启用的触发器不可以与同步表关联。
-
目标库必须有足够的磁盘空间。
-
支持目标数据库中的表比源数据库多列场景,但是需要避免以下场景可能导致的任务失败。
目标端多的列要求非空且没有默认值,源端insert数据,同步到目标端后多的列为null,不符合目标端要求。
目标端多的列设置固定默认值,且有唯一约束。源端insert多条数据后,同步到目标端后多的列为固定默认值,不符合目标端要求。
-
-
其他使用须知:
-
实时同步过程中,不保证分布式事务的一致性。
-
实时同步过程中,不支持对源库添加协调节点或数据节点,否则会导致任务失败或数据不一致。
-
一般情况下,此链路为Oracle到GaussDB分布式版同步链路的反向逃生链路,并与Oracle到GaussDB分布式版同步链路配合使用,不建议单独使用此链路做其他场景的数据同步。
-
GaussDB->Oracle同步任务默认防回环、防级联(即不支持从实例A同步到实例B,再从实例B同步到实例C)。
-
选择的源库表中不能存在表名称字母相同但大小写不同的表,否则,会导致同步失败。如果此链路作为Oracle到GaussDB分布式的逃生链路使用,建议仅同步Oracle端为大写的schema名和表名,且GaussDB分布式端为小写的schema名和表名。
-
在启动任务后,进入增量同步阶段前,请确保在源库中长事务未启动,启动长事务会阻塞逻辑复制槽的创建,进而引发任务失败。
-
由于长事务导致的创建逻辑复制槽失败或逻辑复制槽不存在的问题,需要通过重置任务来重新启动。
-
进行同步的表要禁用外键,因为DRS并行回放会使得不同表之间的写入顺序和源库不一致,可能会触发外键约束限制,造成同步失败。
-
目标数据库Oracle不支持时间类型为1582-10-05至1582-10-14的日期,这种情况会导致同步前后数据不一致。
-
时间类型在源数据库GaussDB公元前闰年为1、5、9等年,在目标数据库Oracle公元前闰年为0、4、8等年,源数据库公元前闰年2月29日在目标数据库是不支持的日期格式,会因为日期解析失败导致同步失败。
-
如果同步表存在可空的联合唯一约束,由于在GaussDB和Oracle对含null值的约束范围差异,会导致最终数据不一致或任务失败。例如,同步表包含可空的联合唯一约束UNIQUE(C1,C2),在GaussDB可以同时存在多条数据的c1='1'、c2=null,而在Oracle只能存在一条,再插入导致唯一键冲突。
-
受GaussDB逻辑复制能力约束,同一实例上,最多支持同时开启20个逻辑复制槽进行解码。
-
源数据库版本小于94563并且为B或者MySQL兼容模式时,如果开启了b_format参数(例如:set b_format_version='s1'、set b_format_dev_version='s1'或者set b_format_dev_version='s2'),则不支持timestamp with time zone类型的同步。源数据库版本查询可参考如下SQL:
select working_version_num();
-
全量同步过程中须知
- 请勿修改源库和目标库的端口号,请勿修改、删除源库和目标库连接用户的密码、权限,否则可能导致任务失败。
- 请勿在源库执行任何DDL,则可能导致数据不一致或任务失败。
- 请勿在目标库做写入操作,否则可能导致数据不一致。
- 为保证同步任务正常和数据的一致性,如有以上诉求,建议在业务低峰期时重新创建DRS任务。
增量同步中过程须知
- 请勿修改源库和目标库的端口号,请勿修改、删除源库和目标库连接用户的密码、权限,否则可能导致任务失败。
- 请勿在源库执行任何DDL,受限于GaussDB逻辑复制功能,不支持DDL语句的同步,否则可能导致数据不一致或任务失败。
- 请勿修改源库中表的REPLICA IDENTITY值,否则可能导致增量数据不一致或任务失败。
- 请勿在目标库做写入操作,否则可能导致数据不一致。
- 为保证同步任务正常和数据的一致性,如有以上诉求,建议在业务低峰期时重新创建DRS任务。
- 不支持interval partition表复制。
- 在事务中执行DDL语句后,该DDL语句与之后的语句不会被同步。
- 逻辑日志解码受限于GaussDB内核的解码能力,存在一些使用约束,具体约束请参考对应版本GaussDB逻辑解码章节的注意事项说明。
- 含大字段(blob、clob、nclob、long、long raw)的表,大字段不会作为增量数据where条件,建议保证除大字段外的其他字段具有唯一约束的能力。
- 目标库的表中同时包含lob和long或者同时包含lob和long raw,插入或更新long或long raw的长度大于4000时,会出现插入或更新失败,建议使用clob或blob类型。
- 由于无主键表缺乏行的唯一性标志,网络不稳定时涉及少量重试,表数据存在少量不一致的可能性。
数据加工须知
- 列加工时,主键、唯一键和分布列不可以被过滤。
同步对比使用须知
- 建议在源库的业务低峰期进行数据比对,防止误报不一致数据,以及减少对源库和DRS任务的冲击。
- 在增量同步过程中做对比时,源库若存在写入,则对比结果可能不一致。
- 不支持在全量同步过程中做对比。
- 不支持数据对比过程中做限速。
结束任务须知
任务正常结束
- 结束时将自动删除任务在源库创建的流复制槽。
任务强制结束
- 强制结束同步任务,需要手动删除源库可能残留的复制槽,可参考GaussDB分布式版为源强制结束任务章节的指导进行操作。
- 强制结束同步任务,目标数据库中可能存在以drs_为前缀命名的无主键临时表,需要用户手动删除。
- 复制槽命名规则取决于数据库内核版本(可通过select working_version_num();命令查看),版本号低于92556默认使用串行解码,复制槽名命名规则为“replication_slot_唯一性标识”;版本号大于等于92556默认使用并行解码,复制槽名命名规则为“drs_唯一性标识”。其中唯一性标识需要将任务node id中的“-”替换为“_”获取,node id可在DRS任务同步日志页面查看“task node id is ***”日志找到。
前提条件
-
已登录数据复制服务控制台。
-
账户余额大于等于0元。
-
满足实时同步支持的数据库类型和版本,详情请参见支持的数据库。
-
当用户创建DRS任务使用的是子账号时,请先确认已添加过委托。创建委托方法,可参考委托管理。
-
已阅读以上使用须知。
更多详情请参考GaussDB 文档中心:doc.hcs.huawei.com/db/zh-cn/ga…