---
title: "DBMS_DATA_DICT - OceanBase 数据库 V4.6.0 | OceanBase 文档中心"
description: DBMS_DATA_DICT DBMS_DATA_DICT 用于控制数据字典的调度。 语法 禁止调度数据字典 CALL DBMS_DATA_DICT.DISABLE_DUMP(); 注意 如果执行时字典配置项 dump_data_dictionary_to_log_interval 不为 0 ，则执行失败，并提示用户…
---
切换语言

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

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

# DBMS_DATA_DICT

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

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/700.reference/600.pl-reference/200.pl-mysql/1000.pl-system-package-mysql/23000.dbms-data-dict-mysql/100.dbms-data-dict-mysql.md)  

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

## 语法

### 禁止调度数据字典

```sql
CALL DBMS_DATA_DICT.DISABLE_DUMP();

```

#### 注意

如果执行时字典配置项 [dump_data_dictionary_to_log_interval](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000005685346) 不为 `0`，则执行失败，并提示用户设置该配置项为 `0`。

### 允许调度数据字典

```sql
CALL DBMS_DATA_DICT.ENABLE_DUMP();

```

### 手动触发生成字典

```sql
CALL DBMS_DATA_DICT.TRIGGER_DUMP(DICT_ITEM_RETENTION_BY_DAY);

```

### 调整字典的定时 DUMP 周期

```sql
CALL DBMS_DATA_DICT.MODIFY_DUMP_INTERVAL(INTERVAL_EXPR);

```

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

- 租户建立后会立即自动触发生成一次数据字典。
 - 开启归档时会立即自动触发生成一次数据字典。

#### 注意

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

### 调整字典历史记录的回收间隔

```sql
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 |

## 示例

### 禁止调度数据字典

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

```

### 允许调度数据字典

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

```

### 手动触发生成字典

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

```

### 调整字典的定时 DUMP 周期

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

```

### 调整字典历史记录的回收间隔

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

```

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