修改系统参数

OceanBase 迁移服务（OceanBase Migration Service，OMS）支持 Admin 用户修改系统参数，普通用户仅支持查看系统参数。

操作步骤

1. 登录 OMS 控制台。

2. 在左侧导航栏，单击 系统管理 > 系统参数。

   系统参数 页面为您详细列举每个配置项的 参数名称、取值、所属模块、描述 和 修改时间。

   参数	描述	默认值
   oms.oceanbase.logproxy.pool	用于控制 OMS OceanBase logProxy 的配置，OMS 自动识别该参数。详情请参见 oblogproxy 参数说明。	{"default":""}
   operation_audit_log.enable	操作审计功能的开关。操作审计功能的详情请参见 操作审计。	false
   operation_audit_log.retention_time	操作审计记录的保留时间。建议取值范围在 1 至 1095 之间，单位为天。	7
   oms.captcha.enable	验证码开关，默认关闭。修改为 true 后，登录页面会展示图片验证码，验证码 10 分钟超时失效。此时登录 OMS 需要输入图片验证码的内容，超时或输入错误都会导致登录失败。	false
   oms.user.password.expiration.date.config	该参数用于控制用户密码的过期策略。	{"rootRolePasswordValidityDays":90,"rootViewerRolePasswordValidityDays":90,"adminRolePasswordValidityDays":90,"adminViewerRolePasswordValidityDays":90,"userRolePasswordValidityDays":90,"userViewerRolePasswordValidityDays":90,"userPasswordValidityDaysTipsThreshold":30}
   mysql.store.metabuilder.filter	MySQL Store 是否根据白名单过滤 meta 信息。取值包括 true 和 false： 配置为 true，表示根据白名单进行过滤。 配置为 false，表示不过滤，会拉取所有 meta 信息。 如果没有 Online DDL（通过 RENAME TABLE 实现）的场景，建议配置为 true，以节省获取 meta 信息的耗时。反之，需要配置为 false，否则执行 Online DDL 语句后，会导致后续的数据无法消费。	false
   mysql_to_obmysql.charset.mapping	MySQL 数据库至 OceanBase 数据库 MySQL 租户的数据迁移项目中，对不支持编码的转换规则。	[] 例如，[{"charset":"utf16le","mappedCharset":"utf16"},{"charset":"*","mappedCharset":"utf8mb4"}]
   mysql_to_obmysql.collation.mapping	MySQL 数据库至 OceanBase 数据库 MySQL 租户的数据迁移项目中，对不支持字符序的转换规则。	[] 例如，[{"collation":"utf16le_general_ci","mappedCollation":"utf16_general_ci"},{"collation":"*","mappedCollation":"utf8mb4_general_ci"}]
   obmysql41_to_obmysql40_and_earlier.collation.mapping	迁移 OceanBase 数据库 MySQL 租户 V4.1.0 的数据至 OceanBase 数据库 MySQL 租户 V4.1.0 之前版本时，数据迁移项目对不支持字符序的转换规则。	[{"collation":"latin1_swedish_ci","mappedCollation":"utf8mb4_general_ci"}]
   obmysql41_to_obmysql40_and_earlier.charset.mapping	迁移 OceanBase 数据库 MySQL 租户 V4.1.0 的数据至 OceanBase 数据库 MySQL 租户 V4.1.0 之前版本时，数据迁移项目对不支持编码的转换规则。	[{"charset":"latin1","mappedCharset":"utf8mb4"}]
   alarm.thresholds	告警相关阈值集合。 failedLengthOfTimeThreshold：项目失败告警阈值。 syncDelayThreshold：同步项目告警延迟阈值。 syncFailedLengthOfTimeThreshold：同步项目失败时间告警阈值。 migrateDelayThreshold：迁移项目告警延迟阈值。 migrateFailedLengthOfTimeThreshold：项目失败时间告警阈值。 alarmRestrainTimeOfMin：针对不同告警等级的告警抑制时间。 HIGH：高保护状态。 MEDIUM：中保护状态。 LOW：低保护状态。 IGNORE：无保护状态。	{"delayThreshold":{"HIGH":30,"MEDIUM":300,"LOW":900},"failedLengthOfTimeThreshold":{"HIGH":30,"MEDIUM":300,"LOW":900},"alarmRestrainTimeOfMin":{"HIGH":3,"MEDIUM":3,"LOW":3,"IGNORE":100},"rule":"OMS_CONFIG_RULE_ALARM_THRESHOLDS"}
   ha.config	HA 开关。详情请参见 修改高可用功能的配置。	{"enable":false,"enableHost":false,"enableStore":true,"perceiveStoreClientCheckpoint":false,"enableConnector":true,"enableJdbcWriter":true,"subtopicStoreNumberThreshold":5,"checkRequestIntervalSec":600,"checkJdbcWriterIntervalSec":600,"checkHostDownIntervalSec":540,"checkModuleExceptionIntervalSec":240,"clearAbnormalResourceHours":72}
   migration.checker.params.fast	Full-Verification 快速档位的配置值。 limitator.platform.threads.number：线程数。 limitator.select.batch.max：全量迁移/校验查询批大小。 limitator.image.insert.batch.max：全量迁移插入批大小。 limitator.datasource.connections.max：连接数。如果并发数超过连接数，并发数据将无效。 limitator.java.opt：JVM 参数配置。 task.checker_jvm_param：Full-Import/Full-Verification 组件的 JVM 参数。 task.new.migrate.job.reader.worker.num：读取源端数据使用的线程数。 task.new.migrate.job.writer.worker.num：写入目标端使用的线程数。 task.new.migrate.job.write.batch.size：写入目标端单批次最大 batch 条数。 task.new.migrate.job.data.queue.size：读取数据的队列大小。如果未被 Dispatcher 消费的数据量超过该值，则 Reader 会阻塞。 task.new.migrate.job.batch.queue.size：攒批队列的大小。如果未被 Writer 消费的 Batch 数量超过该值，则 Dispatcher 会阻塞。 task.new.migrate.job.splitor.queue.size：切片队列的大小。如果未被读取数据的 split 超过该值，则 split 过程会暂停。	{"limitator.platform.threads.number":32,"limitator.select.batch.max":1200,"limitator.datasource.connections.max":50,"limitator.java.opt":null,"task.checker_jvm_param":"-server -Xms16g -Xmx16g -Xmn8g -Xss512k","task.new.migrate.job.reader.worker.num":32,"task.new.migrate.job.writer.worker.num":32,"task.new.migrate.job.write.batch.size":200,"task.new.migrate.job.data.queue.size":32768,"task.new.migrate.job.batch.queue.size":256,"task.new.migrate.job.splitor.queue.size":256}
   migration.checker.params.normal	Full-Verification 正常档位的配置值。 limitator.platform.threads.number：线程数。 limitator.select.batch.max：全量校验查询批大小。 limitator.image.insert.batch.max：全量迁移插入批大小。 limitator.datasource.connections.max：连接数。如果并发数超过连接数，并发数据将无效。 limitator.java.opt：JVM 参数配置。 task.checker_jvm_param：Full-Import/Full-Verification 组件的 JVM 参数。 task.new.migrate.job.reader.worker.num：读取源端数据使用的线程数。 task.new.migrate.job.writer.worker.num：写入目标端使用的线程数。 task.new.migrate.job.write.batch.size：写入目标端单批次最大 batch 条数。 task.new.migrate.job.data.queue.size：读取数据的队列大小。如果未被 Dispatcher 消费的数据量超过该值，则 Reader 会阻塞。 task.new.migrate.job.batch.queue.size：攒批队列的大小。如果未被 Writer 消费的 Batch 数量超过该值，则 Dispatcher 会阻塞。 task.new.migrate.job.splitor.queue.size：切片队列的大小。如果未被读取数据的 split 超过该值，则 split 过程会暂停。	{"limitator.platform.threads.number":8,"limitator.select.batch.max":600,"limitator.datasource.connections.max":50,"limitator.java.opt":null,"task.checker_jvm_param":"-server -Xms8g -Xmx8g -Xmn4g -Xss512k","task.new.migrate.job.reader.worker.num":8,"task.new.migrate.job.writer.worker.num":8,"task.new.migrate.job.write.batch.size":200,"task.new.migrate.job.data.queue.size":32768,"task.new.migrate.job.batch.queue.size":256,"task.new.migrate.job.splitor.queue.size":256}
   migration.checker.params.steady	Full-Verification 平稳档位的配置值。 limitator.platform.threads.number：线程数。 limitator.select.batch.max：全量校验查询批大小。 limitator.image.insert.batch.max：全量迁移插入批大小。 limitator.datasource.connections.max：连接数。如果并发数超过连接数，并发数据将无效。 limitator.java.opt：JVM 参数配置。 task.checker_jvm_param：Full-Import/Full-Verification 组件的 JVM 参数。 task.new.migrate.job.reader.worker.num：读取源端数据使用的线程数。 task.new.migrate.job.writer.worker.num：写入目标端使用的线程数。 task.new.migrate.job.write.batch.size：写入目标端单批次最大 batch 条数。 task.new.migrate.job.data.queue.size：读取数据的队列大小。如果未被 Dispatcher 消费的数据量超过该值，则 Reader 会阻塞。 task.new.migrate.job.batch.queue.size：攒批队列的大小。如果未被 Writer 消费的 Batch 数量超过该值，则 Dispatcher 会阻塞。 task.new.migrate.job.splitor.queue.size：切片队列的大小。如果未被读取数据的 split 超过该值，则 split 过程会暂停。	{"limitator.platform.threads.number":4,"limitator.select.batch.max":200,"limitator.datasource.connections.max":50,"limitator.java.opt":null,"task.checker_jvm_param":"-server -Xms4g -Xmx4g -Xmn2g -Xss512k","task.new.migrate.job.reader.worker.num":4,"task.new.migrate.job.writer.worker.num":4,"task.new.migrate.job.write.batch.size":100,"task.new.migrate.job.data.queue.size":32768,"task.new.migrate.job.batch.queue.size":256,"task.new.migrate.job.splitor.queue.size":256}
   migration.db.support_versions	数据迁移对源端数据库版本的支持情况。 键是数据库类型，值是对数据库版本的正则匹配表达式。 "MYSQL": "(5.5\|5.6\|5.7\|8.0).*"：表示 OMS 支持 MySQL 数据库 V5.5、V5.6、V5.7 和 V8.0。 "MARIADB": "10.\[12345\].\*"：表示 OMS 支持 MariaDB V10.1.0~V10.5.9。 "ORACLE": "1\[01289\].\*"：OMS 支持的 Oracle 数据库版本为 10G/11G/12C/18C/19C。 "DB2": "(9.7\|10.1\|10.5\|11.1\|11.5).\*"：OMS 支持的 DB2 LUW 数据库版本为 Linux 或 AIX 操作系统上的 V9.7、V10.1、V10.5、V11.1 和 V11.5。	{ "MYSQL": "(5.5|5.6|5.7|8.0).*", "MARIADB": "10.[12345].*", "ORACLE": "1[01289].*", "DB2": "(9.7|10.1|10.5|11.1|11.5).*", "POSTGRESQL": "(10).*"}
   migration.mysql.support_collations	数据迁移的 MySQL 源端支持字符序白名单。	["binary","gbk","gb18030","utf8mb4","utf16","utf8"]
   migration.mysql.support_charsets	数据迁移的 MySQL 源端支持编码白名单。里面的值代表 MySQL 支持的编码数组，里面的一个元素等于一个 MySQL 编码。	["binary","gbk","gb18030","utf8mb4","utf16","utf8"]
   migration.mysql.support_datatypes	数据迁移的 MySQL 源端支持字段类型白名单。里面的值代表 MySQL 支持的字段类型数组，里面的一个元素等于一个 MySQL 字段类型。	[]
   migration.oracle.unsupport_datatypes	数据迁移的 oracle 源端支持字段类型黑名单。里面的值代表 Oracle 不支持的字段类型数组，里面的一个元素等于一个 Oracle 字段类型。	["LONG","LONG RAW","XMLTYPE","UNDEFINED","BFILE","ROWID","UROWID"]
   ops.dms.logic_name.suffix.pattern	基于 DMS 逻辑表同步的前缀。	空
   ops.store.max_count_per_subtopic	一个子 topic 下最多可以启动多少个 Store 进程。 里面的值代表最多可以启动的个数。	6
   precheck.skippable_flags	是否可以跳过预检查。 对于失败的预检查项，如果您确认不会影响后续使用，可以修改 precheck.skippable_flags 的配置项为 true，该参数的值为 JSON。例如： { "DB_ACCOUNT_FULL_READ_PRIVILEGE": true, "DB_ACCOUNT_INCR_READ_PRIVILEGE":true, "DB_SERVICE_STATUS":true } 不同预检查项对应的值请参见下文《预检查项说明》模块的内容。	{}
   sync.unified.config	OMS 同步项目统一配置项，包含： enableHeartBeatRecordToDataHub：是否投递心跳。 enableHadoopVendorsKafkaServer：是否为 Hadoop 版 Kafka。 disableIdentificationAlgorithm：当创建需要 SSL 认证的 Kafka 数据源时，默认对 Kafka 地址进行主机名（域名）验证。如果所提供的 SSL 根证书没有该 Kafka 地址信息，您可以将该参数设置为 true，即关闭主机名验证。 checkStoreStartedMinSyncProcess：判断 Store 是否启动正常的最小拉取进度，默认为 3 秒，支持动态配置。 只有 Store 处于运行中，且拉取进度超过所配置的最小拉取进度后，才会认为 Store 启动成功，开始进入全量阶段。 fullJvmMem：全量 Full-Import 初始化内存，默认为 4096 MB。 incrJvmMem：增量 Incr-Sync 初始化内存，默认为 2048 MB。	{"enableHeartBeatRecordToDataHub":false,"enableHadoopVendorsKafkaServer":false,"disableIdentificationAlgorithm":false,"checkStoreStartedMinSyncProcess":3,"fullJvmMem":4096,"incrJvmMem":2048}
   store.topic.mode.config	用于控制 OMS 对数据同步项目中 Store Subtopic 白名单的构造规则。 OceanBase Store Subtopic 支持不共享模式和共享模式，共享模式包括集群共享和租户共享。 字段 oceanbase 下，mode 包括 UN_SHARE（非共享）、DATABASE（数据库级别）、OCEANBASE_TENANT（租户级别）和 OCEANBASE_CLUSTER（集群级别），mode_num 表示指定模式下的最大订阅粒度。 集群共享：此时同一个集群下的 Store 复用，租户下的配置无效，会复用第一个创建的 Store。当该 Store 的位点不满足时，才会创建新的 Store。 租户共享： 当 mode_num 为 1 时，不同租户会创建不同的 Store。 当 mode_num 大于 1 时，会出现多个租户共用一个 Store 的情况。受影响的租户数为 mode_num 的取值-1，会复用第一个创建的 Store。当该 Store 的位点不满足时，才会创建新的 Store。 MySQL Store Subtopic 目前仅支持根据服务实例粒度订阅。 字段 mysql 下，mode 目前支持 INSTANCE（实例级别）和 UN_SHARE（非共享）。 Oracle Store Subtopic 目前仅支持根据数据库粒度订阅。 字段 oracle 下，mode 目前支持 DATABASE（数据库级别）和 UN_SHARE（非共享）。	{"oceanbase":{"mode":"OCEANBASE_TENANT","modeNum":1},"mysql":{"mode":"INSTANCE","modeNum":1},"oracle":{"mode":"DATABASE","modeNum":1}}
   sync.connnector.max.size	用于控制数据同步项目的最大数量。	2
   sync.ddl.supported	数据同步项目支持的 DDL 类型。	{"supportConfigs":{"ADB_SINK":["ALTER_TABLE","ALTER_TABLE_ADD_COLUMN","ALTER_TABLE_MODIFY_COLUMN"],"DATAFLOW_SINK":["ALTER_TABLE","ALTER_TABLE_ADD_COLUMN","ALTER_TABLE_MODIFY_COLUMN"]}}
   store.logic.config.url.config	如果不能直接获取 ODP 逻辑表的 configUrl，您可以通过该参数进行手动配置。configUrlMap 的 key 是 {ip}:{port}-{cluster}，value 是正确的 configUrl。	{"enabled":false,"configUrlMap":{}}
   migration.timeout	执行迁移对象超时配置。	{"ddl.timeout.in.private.cloud": 120000, "ddl.timeout.in.public.cloud": 600000}
   migration.db.dest.support_versions	数据迁移对目标端数据库版本的支持情况。	{"POLARDB_X_1": {"OB_MYSQL": "(1|2|3).*"}}
   migration.record.init.batch_size	结构迁移记录初始化批大小。	100

3. 单击目标参数 取值 列下的编辑图标。

4. 在 修改取值 对话框中，配置 取值，您也可以 恢复默认值。

5. 单击 确定。

预检查项说明

配置 precheck.skippable_flags 时，您可以根据下表查询 JSON 中的 key，值为 true 表示可跳过，值为 false 表示不可以跳过。例如，设置唯一键检查和外键检查的预检查项为可跳过，则在 precheck.skippable_flags 中的配置值如下：

{
  "DB_UK_INDEX": true,
  "DB_FOREIGN_REFERENCE":true,
}

您可以登录 OMS 控制台，进入数据迁移项目的详情页面，在 预检查 页签下查看预检查项目名称，去除"源端-"和"目标端"前缀后，对照下表查看其对应的 key 值。