--- title: "OBCDC 常见配置项 - OceanBase 数据库 V4.2.1 | OceanBase 文档中心" description: OBCDC 常见配置项 本文提供 OBCDC 常用的配置项及说明。全部配置项请参考 OBCDC 配置项说明 。 配置项 功能 默认值 取值范围 说明 log_level OBCDC 日志 ALL.*:INFO; PALF.*:WARN; SHARE.SCHEMA:INFO 不涉及 日志级别，可以按模块调控 max_l… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.2.1 LTS # OBCDC 常见配置项 更新时间：2026-04-16 13:11:33 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.1/zh-CN/700.reference/1500.Components-and-Tools/300.data-integrate/400.cdc/200.obcdc/200.obcdc-parameters/100.general-obcdc-configuration-items.md) 本文提供 OBCDC 常用的配置项及说明。全部配置项请参考 [OBCDC 配置项说明](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000221094)。 | 配置项 | 功能 | 默认值 | 取值范围 | 说明 | | --- | --- | --- | --- | --- | | log_level | OBCDC 日志 | ALL.*:INFO; PALF.*:WARN; SHARE.SCHEMA:INFO | 不涉及 | 日志级别，可以按模块调控 | | max_log_file_count | OBCDC 日志 | 40 | [0, +∞) | 最多保存的日志个数，一个日志文件 256M | | rootserver_list | 连接 OceanBase 数据库 | `\|` | 不涉及 | 启动时指定 Root Service 所在机器信息 | | cluster_url | 连接 OceanBase 数据库 | `\|` | 不涉及 | obconfig_url，OceanBase 集群 RS 信息的入口 | | cluster_user | 连接 OceanBase 数据库 | `\|` | 不涉及 | 系统租户用户名（有 `oceanbase` 库读权限） | | cluster_password | 连接 OceanBase 数据库 | `\|` | 不涉及 | 系统租户用户名对应的密码 | | tenant_endpoint | 连接 OceanBase 数据库 | `\|` | 不涉及 | 普通租户的机器信息，格式为 `svr_ip:sql_port` | | tenant_user | 连接 OceanBase 数据库 | `\|` | 不涉及 | 租户用户（有系统表读权限） | | tenant_password | 连接 OceanBase 数据库 | `\|` | 不涉及 | 租户用户的密码 | | rs_sql_connect_timeout_sec | 连接 OceanBase 数据库 | 40 | [0, +∞) | RS 机器（系统租户）连接超时时间（online schema 模式用于用户获取 Schema） | | rs_sql_query_timeout_sec | 连接 OceanBase 数据库 | 30 | [0, +∞) | RS 的 SQL 请求超时时间 | | tenant_sql_connect_timeout_sec | 连接 OceanBase 数据库 | 40 | [0, +∞) | 对普通租户的机器的连接超时时间 | | tenant_sql_query_timeout_sec | 连接 OceanBase 数据库 | 30 | [0, +∞) | 普通租户的 SQL 请求超时时间 | | fetch_log_rpc_timeout_sec | 日志拉取 | 15 | [0, +∞) | 日志拉取超时时间 | | cluster_id_black_list | 数据过滤 | `\|` | 不涉及 | 需参考 `ob_org_cluster_id` 的值进行配置，ob_org_cluster_id 的详细介绍可参见 [ob_org_cluster_id](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000220681) | | tb_white_list | 数据过滤 | *.*.* | 不涉及 | 设置表的白名单（租户.DB.TB，租户模式下，租户部分需指定为同步的租户） | | tb_black_list | 数据过滤 | `\|` | 不涉及 | 设置表的黑名单 | | working_mode | 工作模式 | storage | {storage, memory} | storage 模式下，REDO 日志会通过 rocksdb 持久化在本地，重启时会清空本地存储 | | fetching_log_mode | 工作模式 | integrated | {integrated, direct} | 拉取日志模式，integrated 表示通过 RPC 从 OBServer 节点拉取日志，direct 表示直接读取归档文件 | | archive_dest | 工作模式 | `\|` | 不涉及 | 当 fetching_log_mode 配置为 direct 模式时才会生效，用于给 CDC 提供 OceanBase 数据库租户的归档路径信息（OSS 模式下需要包含访问密钥等） | | meta_data_refresh_mode | 工作模式 | online | {online, data_dict} | 元数据来源，online 模式表示通过 SQL 读内部表构建 Schema，data_dict 模式表示通过日志中的数据字典构建 Schema。CDC 同步 OceanBase 数据库 V4.2 及之后版本数据时会忽略用户配置，强制使用 data_dict 模式，若需使用 online 模式，需额外修改 `skip_ob_version_compat_check` 配置项为 1 | | skip_ob_version_compat_check | 工作模式/版本兼容性 | 0 | {0, 1} | 控制是否忽略版本检查，取值为 1 时表示忽略版本检查，部分同步高版本数据场景需要设置为 1（不建议） | | pause_redo_dispatch_task_count_threshold | 流量控制 | 80 | [0, 100] | 设置 USER_QUEUE 或 RESOURCE_COLLECTOR 模块任务数量和对应队列长度的比值，比值达到设置的值时会触发下发 REDO 日志限流 | | part_trans_task_active_count_upper_bound | 流量控制 | 0 | [0, +∞) | 预期分配的参与者事务数量的上限，取值为 0 时表示 CDC 内部自动调控，部分场景需要人工修改。流控参数之一，和 memory_limit（CDC 配置项）类似，不会严格限制，否则 CDC 同步会卡住 | | part_trans_task_reusable_count_upper_bound | 流量控制 | 0 | [0, +∞) | 预期可复用的参与者事务（即 CDC 内处理完成待消费或回收）数量的上限，取值为 0 时表示 CDC 内部自动调控，部分场景需要人工修改。流控参数之一，和 memory_limit（CDC 配置项） 类似，不会严格限制，否则 CDC 同步会卡住 | | part_trans_task_prealloc_page_count | 流量控制 | 20000 | [0, +∞) | 缓存的参与者事务的上限，调大可能会导致 CDC 空闲期内存占用升高 | | data_start_schema_version | LogRecord 输出 | `\|` | 不涉及 | 指定 Schema 版本来构建 CDC 内的 Schema，格式为 tenant_id:schema_version，多个租户使用 `\|` 分隔 | | timezone | LogRecord 输出 | +8:00 | 时间偏移值 | 用于处理使用本地时区写入的时间数据，需要和 OBServer 节点机器使用的本地时区一致，当部分数据在写入的 Session 中指定了时区时，如果需要 CDC 的输出与用户写入的数据一致，需要将该配置项设置为 Session 中指定的时区 | | timezone_info_fpath | LogRecord 输出 | `etc/timezone_info.conf` | 不涉及 | 时区文件的路径 | | enable_hbase_mode | LogRecord 输出 | 0 | {0, 1} | 同步的表中有 HBase 模式的表时需要开启该配置 | | enable_compatible_charset | LogRecord 输出 | 0 | {0, 1} | 控制输出的 charset 是否兼容 DRC 的用法 | | enable_convert_timestamp_to_unix_timestamp | LogRecord 输出 | 0 | {0, 1} | 控制是否将 timestamp 转为 unix 时间戳，MySQL 模式下生效 | | enable_oracle_mode_match_case_sensitive | LogRecord 输出 | 0 | {0, 1} | 是否支持按照大小写敏感匹配 Oracle 模式租户的黑白名单 | | enable_output_by_table_def | LogRecord 输出 | 0 | {0, 1} | 控制是否按照用户定义的列顺序输出列 | | enable_output_hidden_primary_key | LogRecord 输出 | 0 | {0, 1} | 控制是否输出隐藏主键 | | enable_output_invisible_column | LogRecord 输出 | 0 | {0, 1} | 控制是否输出不可见列 | 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线