首批通过分布式安全可靠测评，为关键业务系统打造
obcdc_tailf
更新时间：2026-06-01 10:28:34
编辑
分享
什么是 obcdc_tailf
obcdc_tailf 是一个简单的二进制，用以调用 obcdc 动态库，输出 OceanBase 数据库增量数据。它以指定的格式将 obcdc 中拿到的数据输出（到文件或者屏幕），可以体验 obcdc 功能，观察 OceanBase 数据库的增量事务数据。
使用说明
启动参数
obcdc_tailf 的启动参数及说明可以通过 ./bin/obcdc_tailf -h 命令获取。同样，运行环境需要保证能链接到所有需要的动态库。
说明
使用 obcdc_tailf 的启动参数指定文件路径时，均灵活支持设置为相对路径或绝对路径以满足不同需求。
| 参数 | 是否独立参数 | 含义 |
|---|---|---|
| -f | N | 指定 obcdc 配置文件的路径，参数后面内容为配置文件路径。配置文件填写参考 obcdc 配置项说明。 |
| -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 的情况，会报如下错：
./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 路径后，在环境变量中指定动态库搜索路径。具体操作步骤如下：
执行 find 命令找到
libobcdc.so.4路径[admin@test001 ~]$ find / -name libobcdc.so.4若环境中存在动态库
libobcdc.so.4，会输出动态库所在的路径，如下所示：/home/admin/oceanbase-ce/lib/libobcdc.so.4给环境变量
LD_LIBRARY_PATH指定的动态库搜索路径[admin@test001 ~]$ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/admin/oceanbase-ce/lib/
