修改系统参数

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

操作步骤

1. 登录 OMS 社区版控制台。

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

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

   参数	描述	默认值
   struct.obkv.createtable	迁移 HBase 数据库的数据至 OBKV 时，您可以通过修改该参数的取值，来设置全局任务的结构迁移默认在 OBKV 中的建表语句。	create table if not exists {TABLE_NAME} (Kvarbinary(1024) not null,Qvarbinary(256) not null,Tbigint not null,Vvarbinary(1048576),primary key(K,Q,T)) partition by key(K) partitions 64;
   mysql_to_obmysql.charset.mapping	MySQL 数据库至 OceanBase 社区版的数据迁移任务中，对不支持编码的转换规则。	[] 例如，[{"charset":"utf16le","mappedCharset":"utf16"},{"charset":"*","mappedCharset":"utf8mb4"}]
   sync.unified.config	OMS 社区版同步任务统一配置项，包含： enableHadoopVendorsKafkaServer：是否为 Hadoop 版 Kafka。 disableIdentificationAlgorithm：当创建需要 SSL 认证的 Kafka 数据源时，默认对 Kafka 地址进行主机名（域名）验证。如果所提供的 SSL 根证书没有该 Kafka 地址信息，您可以将该参数设置为 true，即关闭主机名验证。 checkStoreStartedMinSyncProcess：判断 Store 是否启动正常的最小拉取进度，默认为 3 秒，支持动态配置。 只有 Store 处于运行中，且拉取进度超过所配置的最小拉取进度后，才会认为 Store 启动成功，开始进入全量阶段。 fullJvmMem：全量 Connector 初始化内存，默认为 4096 MB。 incrJvmMem：增量 Connector 初始化内存，默认为 2048 MB。	{"enableHadoopVendorsKafkaServer":false,"checkStoreStartedMinSyncProcess":3,"fullJvmMem":4096,"incrJvmMem":2048}
   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"]}}
   sync.connnector.max.size	用于控制数据同步任务的最大数量。	2
   struct.transfer.config	结构迁移任务执行相关的配置值。	{"dbcat.ob.query.timeout":15,"ob.parallel":4,"independent.obj.convert.batch.size":50,"independent.obj.convert.partition.size":10,"independent.obj.execute.batch.size":50,"independent.obj.execute.partition.size":2,"independent.core.pool.size":256,"independent.max.pool.size":256,"independent.queue.capacity":16,"checkenable":true}
   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（非共享）。	{"oceanbase":{"mode":"OCEANBASE_TENANT","modeNum":1},"mysql":{"mode":"INSTANCE","modeNum":1}}
   precheck.skippable_flags	是否可以跳过预检查。对于失败的预检查项，如果您确认不会影响后续使用，可以修改 precheck.skippable_flags 的配置项为 true，该参数的值为 JSON。例如： { "DB_ACCOUNT_FULL_READ_PRIVILEGE": true, "DB_ACCOUNT_INCR_READ_PRIVILEGE":true, "DB_SERVICE_STATUS":true } 不同预检查项对应的值请参见下文《预检查项说明》模块的内容。	{}
   ops.store.max_count_per_subtopic	一个子 topic 下最多可以启动多少个 Store 进程。里面的值代表最多可以启动的个数。	6
   oms.user.password.expiration.date.config	该参数用于控制用户密码的过期策略。	{"rootRolePasswordValidityDays":90,"rootViewerRolePasswordValidityDays":90,"adminRolePasswordValidityDays":90,"adminViewerRolePasswordValidityDays":90,"userRolePasswordValidityDays":90,"userViewerRolePasswordValidityDays":90,"userPasswordValidityDaysTipsThreshold":30}
   oms.captcha.enable	验证码开关，默认关闭。修改为 true 后，登录页面会展示图片验证码，验证码 10 分钟超时失效。此时登录 OMS 社区版需要输入图片验证码的内容，超时或输入错误都会导致登录失败。	false
   obmysql41_to_obmysql40_and_earlier.collation.mapping	迁移 OceanBase 社区版 V4.1.0 的数据至 OceanBase 社区版 V4.1.0 之前版本时，数据迁移任务对不支持字符序的转换规则。	[{"collation":"latin1_swedish_ci","mappedCollation":"utf8mb4_general_ci"}]
   obmysql41_to_obmysql40_and_earlier.charset.mapping	迁移 OceanBase 社区版 V4.1.0 的数据至 OceanBase 社区版 V4.1.0 之前版本时，数据迁移任务对不支持编码的转换规则。	[{"charset":"latin1","mappedCharset":"utf8mb4"}]
   mysql_to_obmysql.collation.mapping	MySQL 数据库至 OceanBase 数据库 MySQL 租户的数据迁移任务中，对不支持字符序的转换规则。	[] 例如，[{"collation":"utf16le_general_ci","mappedCollation":"utf16_general_ci"},{"collation":"*","mappedCollation":"utf8mb4_general_ci"}]
   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"}
   mysql.store.metabuilder.filter	MySQL Store 是否根据白名单过滤 meta 信息。取值包括 true 和 false： 配置为 true，表示根据白名单进行过滤。 配置为 false，表示不过滤，会拉取所有 meta 信息。 如果没有 Online DDL（通过 RENAME TABLE 实现）的场景，建议配置为 true，以节省获取 meta 信息的耗时。反之，需要配置为 false，否则执行 Online DDL 语句后，会导致后续的数据无法消费。	false
   migration.timeout	执行迁移对象超时配置。	{"ddl.timeout.in.private.cloud": 172800000, "ddl.timeout.in.public.cloud": 172800000}
   migration.record.init.batch_size	结构迁移记录初始化批大小。	100
   migration.mysql.support_datatypes	数据迁移的 MySQL 源端支持字段类型白名单。里面的值代表 MySQL 支持的字段类型数组。里面的一个元素等于一个 MySQL 字段类型。	[]
   migration.mysql.support_collations	数据迁移的 MySQL 源端支持字符序白名单。	["binary","gbk","gb18030","utf8mb4","utf16","utf8"]
   migration.mysql.support_charsets	数据迁移的 MySQL 源端支持编码白名单。里面的值代表 MySQL 支持的编码数组。里面的一个元素等于一个 MySQL 编码。	["binary","utf8mb4","utf8"]
   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 版本。 "POSTGRESQL": "(10).\*"：OMS 社区版支持 PostgreSQL 数据库 V10.x。	{ "MYSQL": "(5.5|5.6|5.7|8.0).*", "MARIADB": "10.[12345].*", "POSTGRESQL": "(10).*"}
   migration.db.dest.support_versions	数据迁移对目标端数据库版本的支持情况。	{"POLARDB_X_1": {"OB_MYSQL": "(1	2	3).*"}}
   migration.checker.params.steady	Checker 平稳档位的配置值。 limitator.platform.threads.number：线程数。 limitator.select.batch.max：全量迁移/校验查询批大小。 limitator.image.insert.batch.max：全量迁移插入批大小。 limitator.datasource.connections.max：连接数。如果并发数超过连接数，并发数据将无效。 limitator.java.opt：JVM 参数配置。	{"limitator.platform.threads.number": 4, "limitator.select.batch.max": 200, "limitator.image.insert.batch.max": 100,"limitator.datasource.connections.max":50, "limitator.java.opt":"-server -Xms4g -Xmx4g -Xmn2g -Xss256k"}
   migration.checker.params.normal	Checker 正常档位的配置值。 limitator.platform.threads.number：线程数。 limitator.select.batch.max：全量迁移/校验查询批大小。 limitator.image.insert.batch.max：全量迁移插入批大小。 limitator.datasource.connections.max：连接数。如果并发数超过连接数，并发数据将无效。 limitator.java.opt：JVM 参数配置。	{"limitator.platform.threads.number": 8, "limitator.select.batch.max": 600, "limitator.image.insert.batch.max": 200,"limitator.datasource.connections.max":50, "limitator.java.opt":"-server -Xms8g -Xmx8g -Xmn4g -Xss256k"}
   migration.checker.params.fast	Checker 快速档位的配置值。 limitator.platform.threads.number：线程数。 limitator.select.batch.max：全量迁移/校验查询批大小。 limitator.image.insert.batch.max：全量迁移插入批大小。 limitator.datasource.connections.max：连接数。如果并发数超过连接数，并发数据将无效。 limitator.java.opt：JVM 参数配置。	{"limitator.platform.threads.number": 32, "limitator.select.batch.max": 1200, "limitator.image.insert.batch.max": 400,"limitator.datasource.connections.max":50, "limitator.java.opt":"-server -Xms16g -Xmx16g -Xmn8g -Xss256k"}
   ha.config	HA 开关。详情请参见 修改高可用功能的配置。	{"enable":false,"enableHost":false,"enableStore":true,"enableConnector":true,"enableJdbcWriter":true,"subtopicStoreNumberThreshold":5,"checkRequestIntervalSec":600,"checkHostDownIntervalSec":540,"checkModuleExceptionIntervalSec":240,"clearAbnormalResourceHours":72}
   oms.telemetry	OMS 支持 Telemetry（遥测），enabled 为 true 表示打开。详情请参见 Telemetry 参数说明	{"url":"https://openwebapi.oceanbase.com","enabled":true}
   oms.ce.plugin.log.clean	OMS 社区版 V4.2.3-CE 及之后版本支持的日志清理功能。开启该功能后，每小时运行一次，用于清理不需要的日志，可以避免日志占用磁盘空间过大的问题。 logCleanSwitch：是否开启日志清理，默认值为 false（关闭）。 fuzzyLogNames：需要清理的日志名称，您可以写全名，也可以使用通配符 *（匹配所有）或 ?（匹配一位）。 logRetentionMinutes：日志保留时间。默认值为 -60，表示清理当前时间提前一小时之前的日志。	{"logCleanSwitch":false,"fuzzyLogNames":["congo_20*","liboblog.log.20*","libobcdc.log.20*","connector.20*","common-default.log.20*","check_query.log.20*","common-error.log.20*","oms-ha.log.20*","oms-scheduler.log20*","oms-web.log.20*","oms-step.log.20*","oms-alarm.log.20*","connection-error.log.20*","database.log.20*","oms-api.log.20*","oms-integration.20*","cm-web.log.20*","dao-digest.log.20*","service.log.20*"],"logRetentionMinutes":-60}

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

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

5. 单击 确定。

预检查项说明

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

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

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