修改同步配置

最近更新时间:2024-04-08 11:07:32

我的收藏

操作场景

用户初次配置完同步任务,同步任务已经开始运行,后续如果需要增加同步对象、删除同步对象、修改同步参数配置,都可以通过本操作进行。
修改同步配置后任务会重启,因为是在增量阶段重启,所以对同步数据无影响,仍会接续进行。修改的参数,除数据初始化选项不支持修改,其他的主键冲突策略,SQL 同步策略,库、表、高级对象等,都可以进行修改。
增加对象:同步任务类型为 全量 + 增量同步 时,新增加一个同步对象,DTS 会将新增对象的存量数据和增量数据都同步到目标库;同步任务类型为仅增量同步时,新增加一个同步对象,DTS 只将新增对象的增量数据同步到目标库。
删除对象:修改配置后,删除对象新增的数据不会再同步到目标库,修改操作前已经同步到目标库的数据仍保留,不会删除。
修改主键冲突策略:仅对修改配置后新同步的数据应用新的主键冲突策略。

适用范围

仅如下链路支持修改同步配置操作。
MySQL/MariaDB/Percona/TDSQL-C MySQL -> MySQL
MySQL/MariaDB/Percona -> MariaDB
MySQL/MariaDB/TDSQL-C MySQL -> TDSQL-C MySQL
MySQL/MariaDB/Percona/TDSQL-C MySQL -> Kafka

注意事项

1. 修改同步配置功能于2022年12月上线,仅支持对上线后新发起的任务进行修改,上线前已有的存量任务暂不支持修改。存量任务如需修改请 提交工单 对任务升级。
2. 同步任务需要满足在“同步增量”阶段,任务状态为“运行中”,“目标库与源库时间延迟”小于1GB,这三个条件,才支持修改同步配置。
3. 新增或者删除同步对象时,需要保证相互关联的对象一起选择,否则会导致同步任务失败。
4. 修改同步配置时,仅支持对新增加的库表对象进行重命名操作,历史选择的库表对象,此时不能再进行重命名。如果用户在修改同步配置时,同时又对历史对象进行重命名操作,系统会在校验阶段报错,需要用户自行改回之前的名称。
5. 如果用户初次修改了限速中的全量速率参数(全量导出线程数据和 RPS,全量导入线程数和 RPS),后续进行修改同步对象操作时,会先跳转到限速参数调整界面,建议用户将全量速率参数尽量调大一些(根据源和目标库负载情况综合判断),避免新追加对象后,对新对象的全量同步耗时较久。

操作步骤

1. 登录 DTS 控制台,在左侧导航选择数据同步页,选择指定的同步任务,在操作列单击修改同步配置
任务需要在“同步增量”阶段,任务状态为“运行中”,“目标库与源库数据差距”小于1GB,才支持修改配置。其他的“任务失败”、“任务出错”等都不支持修改配置。

2. (可选)确认是否需要调整速率参数,确认后单击确定
说明:
如果用户初次修改了限速中的全量速率参数(全量导出线程数据和 RPS,全量导入线程数和 RPS),后续进行修改同步对象操作时,会先跳转到限速参数调整界面,建议用户将全量速率参数尽量调大一些(根据源和目标库负载情况综合判断),避免新追加对象后,对新对象的全量同步耗时较久。

3. 进入配置同步任务页,在设置同步选项和同步对象中,修改相关参数,如增加对象、删除对象、修改主键冲突策略等,然后单击保存并下一步。除数据初始化选项不支持修改,其他的选择都支持修改。

4. 任务重新校验,校验通过后,单击启动任务

5. 返回任务列表,任务状态显示为“运行中(动态修改配置)”,表示 DTS 正在对修改配置后的数据进行处理。
说明:
修改同步配置后,当任务处于“运行中(动态修改配置)”,请勿在源数据库执行 DDL 操作,否则可能会导致任务失败。
用户新增同步对象时,DTS 会先将新增对象的存量数据同步到目标库,如果新增对象的存量数据较多,则“运行中(动态修改配置)”这个状态的持续时间也会较长。

当任务状态转换为“运行中”,表示本次修改配置的操作已完成,后续如有需要可以再次发起修改配置的操作。