---
title: "obcdc_tailf - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: obcdc_tailf 什么是 obcdc_tailf obcdc_tailf 是一个简单的二进制，用以调用 obcdc 动态库，输出 OceanBase 数据库增量数据。它以指定的格式将 obcdc 中拿到的数据输出（到文件或者屏幕），可以体验 obcdc 功能，观察 OceanBase 数据库的增量事务数据。 使…
---
切换语言

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

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

# obcdc_tailf

更新时间：2026-06-01 10:28:34

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

## 什么是 obcdc_tailf

obcdc_tailf 是一个简单的二进制，用以调用 obcdc 动态库，输出 OceanBase 数据库增量数据。它以指定的格式将 obcdc 中拿到的数据输出（到文件或者屏幕），可以体验 obcdc 功能，观察 OceanBase 数据库的增量事务数据。

## 使用说明

### 启动参数

obcdc_tailf 的启动参数及说明可以通过 `./bin/obcdc_tailf -h` 命令获取。同样，运行环境需要保证能链接到所有需要的动态库。

#### 说明

使用 obcdc_tailf 的启动参数指定文件路径时，均灵活支持设置为相对路径或绝对路径以满足不同需求。

| 参数 | 是否独立参数 | 含义 |
| --- | --- | --- |
| -f | N | 指定 obcdc 配置文件的路径，参数后面内容为配置文件路径。配置文件填写参考 [obcdc 配置项说明](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685885)。 |
| -d | Y | 后台运行。 |
| -D | N | 指定打印输出数据的文件，您可自定义文件类型，参数后面内容为数据文件路径。 |
| -h | Y | 输出 help 信息。 |
| -H | Y | 输出安全位点信息，参数后面内容为安全位点文件路径。 |
| -o | Y | 屏幕输出数据。 |
| -O | Y | 仅输出 16 进制（NCHAR、NVARCHAR、VARCHAR 等）（其它列不输出）。 |
| -V | Y | 启用校验模式，输出行数据的唯一 ID。 |
| -v | Y | 输出版本信息。 |
| -t | N | 使用秒时间戳启动 obcdc，后面内容为时间戳的值。 |
| -T | N | 使用毫秒时间戳启动 obcdc，后面内容为时间戳的值。 |
| -R | N | 指定运行时间。 |
| -x | Y | 部分列额外输出 16 进制。 |
| -m | Y | 输出 lob 类型列的 MD5 值。 |
| -i | Y | 输出 LogRecord 的详细信息（目前指隐藏主键信息）。 |
| -c | Y | DML 事务仅输出数据的 checksum 值（crc32 算法） |

## 常见问题

在执行 obcdc_tailf 命令时，如果遇到缺少动态库 `libobcdc.so.4` 的情况，会报如下错：

```shell
./bin/obcdc_tailf: error while loading shared libraries: libobcdc.so.4: cannot open shared object file: No such file or directory

```

您可通过 find 命令找到 `libobcdc.so.4` 路径后，在环境变量中指定动态库搜索路径。具体操作步骤如下：

1. 执行 find 命令找到 `libobcdc.so.4` 路径

   ```shell
   [admin@test001 ~]$ find / -name libobcdc.so.4

   ```

   若环境中存在动态库 `libobcdc.so.4`，会输出动态库所在的路径，如下所示：

   ```shell
   /home/admin/oceanbase-ce/lib/libobcdc.so.4

   ```
 2. 给环境变量 `LD_LIBRARY_PATH` 指定的动态库搜索路径

   ```shell
   [admin@test001 ~]$ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/admin/oceanbase-ce/lib/

   ```

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