--- title: "obcdc 支持数据字典 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: obcdc 支持数据字典 功能介绍 OceanBase 数据库自 V4.1.0.0 起支持数据字典功能，数据字典是一个租户级的服务，其功能是将 OceanBase 集群租户的元信息，包括日志流信息/库表元信息等持久化到日志（clog）中，现阶段主要用途是让数据链路（obcdc）具备仅依赖日志即可获取租户元信息的能力。… --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # obcdc 支持数据字典 更新时间：2026-06-08 12:50:31 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/1500.Components-and-Tools/300.data-integrate/400.cdc/700.cdc-supports-data-dictionary.md) ## 功能介绍 OceanBase 数据库自 V4.1.0.0 起支持数据字典功能，数据字典是一个租户级的服务，其功能是将 OceanBase 集群租户的元信息，包括日志流信息/库表元信息等持久化到日志（clog）中，现阶段主要用途是让数据链路（obcdc）具备仅依赖日志即可获取租户元信息的能力。 数据字典仅服务于用户租户，通过 PALF 持久化在普通租户的系统日志流（SYS_LS）中。用户租户建立后数据字典服务自动开启，运行在租户 SYS_LS 的 LEADER 副本上。 日志归档服务开启时，会自动触发一次异步数据字典生成任务。OceanBase 数据库支持通过租户级配置项 [dump_data_dictionary_to_log_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685346)（自 V4.1.0.0 起支持） 和 `DBMS_DATA_DICT` 系统包调度定时生成数据字典，推荐通过 `DBMS_DATA_DICT` 系统包调度生成数据字典。 OceanBase 数据库自 V4.2.0.0 起支持通过 DBA/CDB 视图来记录数据字典的生成记录，可在系统租户下查询 `CDB_OB_DATA_DICTIONARY_IN_LOG` 视图，或普通租户下查询 `DBA_OB_DATA_DICTIONARY_IN_LOG` 视图获取字典位置信息。 #### 注意 - 根据租户元信息复杂度不同，数据字典生成时间在数秒到数小时不等，设置配置项时需要考虑租户元信息的复杂度，生成周期过短会导致字典生成过于频繁，因数据字典生成为单线程任务，这会导致该线程长期被占用。 - 数据字典生成过程中，所调用的 schema 服务会占用额外内存，租户 schema 数量变更多或者租户内存规格小的情况下，内存占用会比较明显。 ## 使用方式 obcdc 可通过在配置文件中配置 `meta_data_refresh_mode` 选择是否通过日志中的数据字典解析 schema 信息。配置为 `online` 时表示通过 SchemaService 向 OBServer 节点查询 schema 信息，需要能够访问 OBServer 节点；配置为 `data_dict` 表示通过日志中的数据字典解析 schema 信息。 #### 注意 obcdc 同步 OceanBase 数据库 V4.2 及之后版本数据时会忽略用户配置，强制使用 `data_dict` 模式，如需使用 `online` 模式，需额外修改 `skip_ob_version_compat_check` 配置项为 `1`。 例如在配置文件中补充如下内容，obcdc 配置文件的介绍可参见 [配置文件示例](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685884)。 ```conf meta_data_refresh_mode=data_dict ``` 配置后需重启 obcdc 宿主进程，例如使用如下命令启动： ```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://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005682414) 章节。 - CDB_OB_DATA_DICTIONARY_IN_LOG 视图的详细介绍可参见 [oceanbase.CDB_OB_DATA_DICTIONARY_IN_LOG](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684110)。 - DBA_OB_DATA_DICTIONARY_IN_LOG 视图的详细介绍可参见 [oceanbase.DBA_OB_DATA_DICTIONARY_IN_LOG](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005684642)（MySQL 模式）和 [DBA_OB_DATA_DICTIONARY_IN_LOG](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005683841)（Oracle 模式）。 上一篇 下一篇 ![有帮助](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) 咨询热线