---
title: "配置文件示例 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: 配置文件示例 obcdc 的配置文件由一组 key-value 组成，包括必填的配置项和选填的配置项。 说明 obcdc 配置项的详细介绍可参见 obcdc 配置项说明 。 配置文件中必填的配置项为 cluster_user 和 cluster_password ，用于配置 sys 租户下的用户名和密码；需二选一的配…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0

# 配置文件示例

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

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/1500.Components-and-Tools/300.data-integrate/400.cdc/200.obcdc-parameters/50.example-configuration-file.md)  

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

#### 说明

obcdc 配置项的详细介绍可参见 [obcdc 配置项说明](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685885)。

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

```shell
######### [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 开发说明](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683200)。

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

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

```

此处以配置文件相对路径为 `libobcdc.conf`，并将 obcdc 处理后的输出数据保存到 `output.txt` 文件为例，需根据实际情况替换配置文件名和输出数据的保存文件名。obcdc_tailf 命令的详细介绍可参见 [obcdc_tailf](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683201)。

 上一篇 下一篇 ![有帮助](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) 咨询热线