配置文件示例 - OceanBase 数据库 V4.6.0

配置文件示例

更新时间：2026-05-20 08:29:08

obcdc 的配置文件由一组 key-value 组成，包括必填的配置项和选填的配置项。

说明

obcdc 配置项的详细介绍可参见 obcdc 配置项说明。

配置文件中必填的配置项为 cluster_user 和 cluster_password，用于配置 sys 租户下的用户名和密码；需二选一的配置项为 cluster_url 和 rootserver_list，用于配置 OceanBase 数据库中 Root Service 所在的机器信息，二者全都配置时优先使用 rootserver_list 的值。同时也建议配置一些选填的配置项，以配置文件名为 libobcdc.conf 为例，配置文件内容如下：

######### [cluster_info] #########
cluster_db_name=oceanbase
cluster_password=********
cluster_user=test
cluster_url=
# rootserver_list=

######### [working_mode] #########
meta_data_refresh_mode=data_dict

######### [synchronous information] #########
tb_white_list=*.*.*
tb_black_list=|

######### [module] #########
formatter_thread_num=20

######### [log] #########
log_level=ALL.*:INFO;PALF.*:WARN;SHARE.SCHEMA:WARN;TLOG.FETCHER:INFO;TLOG.FORMATTER:INFO;

enable_output_trans_order_by_sql_operation=1

使用配置文件

若通过将 obcdc 接入自己的数据消费链路进行使用，可在编写代码时指定配置文件，相关操作可参见 obcdc 开发说明。

若通过 obcdc_tailf 使用 obcdc 功能，可在执行 obcdc_tailf 命令时指定配置文件，示例如下：

[admin@test oceanbase]$ ./bin/obcdc_tailf -f libobcdc.conf -D output.txt

此处以配置文件相对路径为 libobcdc.conf，并将 obcdc 处理后的输出数据保存到 output.txt 文件为例，需根据实际情况替换配置文件名和输出数据的保存文件名。obcdc_tailf 命令的详细介绍可参见 obcdc_tailf。