DBMS_DATA_DICT - OceanBase 数据库 V4.6.0

DBMS_DATA_DICT

更新时间：2026-06-17 16:25:38

DBMS_DATA_DICT 用于控制数据字典的调度。

语法

CALL DBMS_DATA_DICT.DISABLE_DUMP();

如果执行时字典配置项 dump_data_dictionary_to_log_interval 不为 0，则执行失败，并提示用户设置该配置项为 0。

CALL DBMS_DATA_DICT.ENABLE_DUMP();

CALL DBMS_DATA_DICT.TRIGGER_DUMP(DICT_ITEM_RETENTION_BY_DAY);

CALL DBMS_DATA_DICT.MODIFY_DUMP_INTERVAL(INTERVAL_EXPR);

会触发调度生成字典的场景：

执行时需要字典 DUMP 服务为开启状态（即先执行 ALL DBMS_DATA_DICT.ENABLE_DUMP() ），否则会执行失败。

CALL DBMS_DATA_DICT.MODIFY_DICT_ITEM_RETENTION(DICT_ITEM_RETENTION_BY_DAY)

参数	说明	数据类型
DICT_ITEM_RETENTION_BY_DAY	触发执行生成字典后，执行回收字典的历史 DUMP 记录：携带参数时，取值范围大于等于 `0`。不携带参数或参数为 `0` 时，代表本次 DUMP 不回收字典。	INT
INTERVAL_EXPR	表示期望的调度周期。该参数需遵循 `DBMS_SCHEDULER` 的 `REPEAT_INTERVAL` 的书写格式，并用单引号包裹。例如 `'FREQ=MINUTELY; INTERVAL=120'`。其中： `FREQ` 可选 `SECONDLY`/`DAILY`/`HOURLY`/`WEEKLY`/`YEARLY`。 `INTERVAL` 是执行周期，填写期望执行周期的相应数字即可。两者拼到一起就是 `INTERVAL_EXPR`。	TEXT
DICT_ITEM_RETENTION_BY_DAY	表示期望的字典历史记录回收时间，单位为天。和 `DBMS_DATA_DICT.TRIGGER_DUMP` 携带参数的调用相比，这个存储过程执行后，后续的字典 DUMP 默认都会按照本次指定的时间来回收字典历史记录（除非手动执行带参数的 `DBMS_DATA_DICT.TRIGGER_DUMP` 存储过程）。	INT

CALL DBMS_DATA_DICT.DISABLE_DUMP();
Query OK, 0 rows affected

CALL DBMS_DATA_DICT.ENABLE_DUMP();
Query OK, 0 rows affected

CALL DBMS_DATA_DICT.TRIGGER_DUMP(7);
Query OK, 0 rows affected

CALL DBMS_DATA_DICT.MODIFY_DUMP_INTERVAL('FREQ=MINUTELY; INTERVAL=120');
Query OK, 0 rows affected

CALL DBMS_DATA_DICT.MODIFY_DICT_ITEM_RETENTION(7);
Query OK, 0 rows affected