首批通过分布式安全可靠测评,为关键业务系统打造
查看和修改参数
更新时间:2026-07-02 13:15:50
本文为您介绍如何查看和修改数据迁移任务的参数。
查看参数
处于 未购买、未启动、运行中、修改中、合并中、已完成 和 变配中 状态的数据迁移任务,支持查看参数。
登录 OB Cloud 云数据库控制台。
在左侧导航栏,单击 数据服务 > 数据迁移。
在 数据迁移 页面,单击 数据迁移 页签。
在 任务列表 页面,单击目标任务后的 ... > 查看参数。

您也可以单击目标任务的名称进入详情页面,单击右上角的 查看参数。

在 查看参数 面板,查看当前任务的各项配置。
修改参数
支持修改的参数
处于 未购买、未启动、已暂停 和 失败 状态的数据迁移任务,支持修改参数。不同状态的数据迁移任务,支持修改的参数也不同。
| 数据迁移任务的状态 | 支持修改的参数 |
|---|---|
| 未购买/未启动 |
|
| 已暂停/失败 |
|
操作步骤
登录 OB Cloud 云数据库控制台。
在左侧导航栏,单击 数据服务 > 数据迁移。
在 数据迁移 页面,单击 数据迁移 页签。
在 任务列表 页面,单击目标任务后的 ... > 修改参数。

您也可以单击目标任务的名称进入详情页面,单击右上角的 ... > 修改参数。

在 修改参数 面板,根据业务需求进行修改。
结构迁移
在 Oracle 数据库至 OceanBase 数据库 Oracle 兼容模式租户的数据迁移任务的 选择类型和对象 页面,选中 结构迁移,并且源端和目标端的字符集不一致时,才会显示下述参数。

源端和目标端的字符集不一致(例如,源端为 GBK,目标端为 UTF-8)时,可能会发生字段截断,数据不一致的情况。您可以通过配置 字符类型长度放大倍数 来增加字符类型字段长度。
注意
扩展后的长度不能超过目标端最大限制。
全量迁移
在 选择类型和对象 页面,选中 全量迁移,才会显示下述参数。

参数 描述 读取并发配置 该参数用于配置全量迁移阶段从源端读取数据的并发数,最大限制为 512 并发数过高可能会造成源端压力过大,影响业务。 写入并发配置 该参数用于配置全量迁移阶段往目标端写入数据的并发数,最大限制为 512。并发数过高可能会造成目标端压力过大,影响业务。 是否限制全量迁移速率 您可以根据实际需求决定是否开启全量迁移速率限制。如果开启,请设置 RPS(全量迁移阶段每秒最多可以迁移至目标端的数据行数的最大值限制)和 BPS(全量迁移阶段每秒最多可以迁移至目标端的数据量的最大值限制)。 说明
此处设置的 RPS 和 BPS 仅作为限速限流能力,全量迁移实际可以达到的性能受限于源端、目标端、实例规格配置等因素的影响。
目标端表对象存在记录时处理策略 处理策略包括 停止迁移 和 忽略: - 选择 停止迁移,当目标端表对象存在数据时,全量迁移会报错不允许迁移,请处理好目标端数据后再继续迁移。
注意
如果出错后单击恢复,数据迁移将忽略该配置选项,继续迁移表数据,请谨慎操作。
- 选择 忽略,当目标端表对象存在数据时,如果原数据与写入数据冲突,数据迁移采用将冲突数据记录日志,保留原数据不变的策略进行数据写入。
是否允许索引后置 索引后置功能能够缩短全量迁移耗时,您可以在此处设置是否允许全量数据迁移完成后再创建索引。选择索引后置的注意事项,请参见表格下方的说明。 注意
在 选择迁移类型 页面同时选中 结构迁移 和 全量迁移,才支持设置该选项。
- 仅非唯一键索引支持后置创建。
允许索引后置的情况下,建议您根据 OceanBase 数据库的硬件条件和当前业务流量情况,通过黑屏客户端工具调整以下业务租户参数。
// 文件内存缓冲区限制 ALTER SYSTEM SET _temporary_file_io_area_size = '10' tenant = 'xxx'; // OceanBase 数据库 V4.x 关闭限流 ALTER SYSTEM SET sys_bkgd_net_percentage = 100;- 选择 停止迁移,当目标端表对象存在数据时,全量迁移会报错不允许迁移,请处理好目标端数据后再继续迁移。
增量同步
在 选择类型和对象 页面,选中 增量同步,才会显示下述参数。

参数 描述 DML/DDL 同步 增量同步 包括 DML 同步 和 DDL 同步,您可以根据需要进行自定义配置。详情请参见 自定义配置 DML/DDL。 写入并发配置 该参数用于配置增量同步阶段往目标端写入数据的并发数,最大限制为 512。并发数过高可能会造成目标端压力过大,影响业务。 是否限制增量迁移速率 您可以根据实际需求决定是否开启增量同步速率限制。如果开启,请设置 RPS(增量同步阶段每秒最多可以同步至目标端的数据行数的最大值限制)和 BPS(增量同步阶段每秒最多可以同步至目标端的数据量的最大值限制)。 说明
此处设置的 RPS 和 BPS 仅作为限速限流能力,增量同步实际可以达到的性能受限于源端、目标端、实例规格配置等因素的影响。
增量同步起始位点 - 如果选择迁移类型时已选择 全量迁移,则不显示该参数。
- 如果选择迁移类型时未选择 全量迁移,但选择了 增量同步,请在此处指定迁移某个时间节点之后的数据,默认为当前系统时间。详情请参见 设置增量同步位点。
注意
仅修改双向同步任务的参数时,才显示该参数。
数据冲突时处理策略 包括 忽略报错,保持目标端原有数据 和 忽略冲突,使用源端数据覆盖目标端数据。 定时推进 Binlog 位点 如果开启该功能,您需要配置频率。支持配置的频率范围为 1~60,单位为秒。
配置完成后,数据迁移会在增量同步阶段根据您配置的频率,定期在 MySQL 源数据库执行CREATE DATABASE IF NOT EXISTS test命令,以推进 Binlog 位点。注意
仅迁移 MySQL 数据库的数据至 OceanBase 数据库 MySQL 兼容模式租户时,才显示该参数。
适配 Online DDL 工具 开启该功能后,数据库使用 Online DDL 工具执行无锁结构变更,数据迁移将过滤临时表对象,以提升数据迁移任务的稳定性。详情请参见 适配 Online DDL 工具介绍。 注意
目前适配 Online DDL 工具仅支持源端为 MySQL 数据库,且使用阿里云 DMS、gh-ost 或 pt-osc 进行无锁结构变更操作的场景。
高级选项
当目标端 OceanBase 数据库为 V4.3.0 及之后版本,并且在 修改参数 页面,新增选择 增量同步 > DDL 同步,才会显示该区域的参数。如果您在新建数据迁移任务时,已配置 目标端表对象存储类型,则此处不支持修改。

目标端表对象存储类型包括 默认、行存、列存 和 行列混存,该配置用于确定结构迁移或增量同步时目标端表对象的存储类型。
说明
默认 选项是根据目标端参数自适应其他选项,是结构迁移的表对象或增量 DDL 的新增表对象根据设置的存储类型写对应的结构。
修改完成后,单击 保存。