dump_data_dictionary_to_log_interval

更新时间：2026-06-10 11:57:15

编辑

说明

该配置项从 V4.1.0 版本开始引入。

功能描述

dump_data_dictionary_to_log_interval 用于控制租户数据字典持久化的周期。

权限要求

查询配置项

sys 租户和所有用户租户均可以使用 SHOW PARAMETERS 语句或视图 GV$OB_PARAMETERS 查询该配置项。
修改配置项

sys 租户和用户租户均可修改该配置项。

属性说明

注意

从低版本升级到 V4.4.1 版本，该配置项值会维持低版本的值不变。

属性	描述
参数类型	Time
默认值	0，默认单位为秒说明从 V4.4.1 版本开始默认值由 24H 调整为 0。值为 0 时，将不会根据该配置项调度生成数据字典；如需停止生产数据字典，需要配合 `DBMS_DATA_DICT.DISABLE_DUMP()` 命令。
取值范围	[0s, +∞) 说明从 V4.4.1 版本开始取值范围由 (0s, +∞) 调整为 [0s, +∞) 。
是否可修改	是，支持通过 `ALTER SYSTEM SET` 语句修改。
是否重启 OBSever 节点生效	否，设置后立即生效。

使用说明

数据字典仅服务于用户租户，通过 PALF 持久化在普通租户的系统日志流（SYS_LS）中。用户租户建立后数据字典服务自动开启，运行在租户 SYS_LS 的 LEADER 副本上。

日志归档服务开启时，会自动触发一次异步数据字典生成任务。OceanBase 数据库支持通过租户级配置项 dump_data_dictionary_to_log_interval 和 DBMS_DATA_DICT 系统包（自 V4.4.1 起支持）调度定时生成数据字典，推荐通过 DBMS_DATA_DICT 系统包调度生成数据字典。

OceanBase 数据库自 V4.2.0 版本起支持通过 DBA/CDB 视图来记录数据字典的生成记录，可在系统租户下查询 CDB_OB_DATA_DICTIONARY_IN_LOG 视图，或普通租户下查询 DBA_OB_DATA_DICTIONARY_IN_LOG 视图获取字典位置信息。

配置示例

设置租户数据字典持久化的周期为 24H。

obclient> ALTER SYSTEM SET dump_data_dictionary_to_log_interval = '24H';