---
title: "MODULE DATA - OceanBase 数据库 V4.2.5 | OceanBase 文档中心"
description: MODULE DATA 描述 MODULE DATA 语句有以下两种功能： ALTER SYSTEM LOAD MODULE DATA ... ：该语句用于向某个特定租户导入指定功能。 ALTER SYSTEM CHECK MODULE DATA ... ：该语句用于检查某个特定租户的指定功能是否已导入。 说明 对于…
---
切换语言

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

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

# MODULE DATA

更新时间：2026-04-15 17:16:59

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.5/zh-CN/700.reference/500.sql-reference/100.sql-syntax/100.system-tenants/200.alter-system/1500.module-data.md)  

## 描述

`MODULE DATA` 语句有以下两种功能：

- `ALTER SYSTEM LOAD MODULE DATA ...`：该语句用于向某个特定租户导入指定功能。
 - `ALTER SYSTEM CHECK MODULE DATA ...`：该语句用于检查某个特定租户的指定功能是否已导入。

#### 说明

对于 OceanBase 数据库 V4.2.5 版本，从 V4.2.5 BP2 版本开始支持 `MODULE DATA` 语句。

## 使用限制及注意事项

- 该语句仅支持在 `sys`（系统）租户中执行。
 - 当前版本仅支持向 MySQL 模式租户导入 `REDIS` 模块功能。
 - 当前版本仅支持检查（`CHECK MODULE DATA`）导入的 `REDIS` 模块功能。

## 权限要求

执行该语句的用户需要拥有 `ALTER SYSTEM` 权限。有关 OceanBase 数据库权限的详细介绍，参见 [MySQL 模式下的权限分类](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000001502681)。

## 语法

```sql
ALTER SYSTEM {LOAD | CHECK} MODULE DATA
    MODULE = module_value
    TENANT = tenant_name
    [INFILE = file_path];

module_value:
    REDIS
    | GIS
    | TIMEZONE

```

## 参数说明

| 参数 | 描述 |
| --- | --- |
| LOAD \| CHECK | 用于指定是导入还是检查，具体如下：   - `LOAD`：用于向某个特定租户导入指定功能。 - `CHECK`：用于检查某个特定租户的指定功能是否已导入。 |
| tenant_name | 指定待操作的租户名称。 |
| module_value | 用于指定待操作的功能，详细介绍可参见下文 [module_value](#module_value)。 |
| file_path | 用于指定待导入的 SQL 文件路径。   #### 注意    - 因为 `TIMEZONE` 和 `GIS` 可能出现多版本数据，所以需要指定对应版本的 SQL 文件。因为目前 `TIMEZONE` 和 `GIS` 都只有一个版本，所以支持缺省的 `INFILE` 参数。 - 当前版本 `REDIS` 模块功能不支持 `INFILE` 参数，输入 `INFILE` 参数路径将会报错。 |

### module_value

- `REDIS`：表示操作 `REDIS` 模块功能。
 - `GIS`：表示操作 `GIS` 模块功能。
 - `TIMEZONE`：表示操作 `TIMEZONE` 模块功能。

## 示例

### LOAD MODULE DATA 示例

1. 向租户 `mysql001` 导入 `REDIS` 模块功能。目前 `REDIS` 模块功能不支持使用 `INFILE` 路径，所以会报错。

   ```sql
   ALTER SYSTEM LOAD MODULE DATA
       MODULE = REDIS
       TENANT = mysql001
       INFILE = '/home/admin/test.sql';

   ```

   返回结果如下：

   ```shell
   ERROR 4025 (HY000): loading redis module does not need to specify infile

   ```
 2. 向租户 `mysql001` 导入 `REDIS` 模块功能。

   ```sql
   ALTER SYSTEM LOAD MODULE DATA
       MODULE = REDIS
       TENANT = mysql001;

   ```

   返回结果如下：

   ```shell
   Query OK, 0 rows affected

   ```
 3. 向租户 `mysql001` 导入 `GIS` 模块功能, 其中 `INFILE` 参数是可以省略的，缺省值为 `etc/`, 相应文件在部署目录的 `etc` 目录下。

   ```sql
   ALTER SYSTEM LOAD MODULE DATA
       MODULE = GIS
       TENANT = mysql001
       INFILE = 'etc/';

   ```

   返回结果如下：

   ```
 4. 向租户 `mysql001` 导入 `TIMEZONE` 模块功能, 其中 `INFILE` 参数是可以省略的，缺省值为 `etc/`, 相应文件在部署目录的 `etc` 目录下。

   ```sql
   ALTER SYSTEM LOAD MODULE DATA
       MODULE = TIMEZONE
       TENANT = mysql001
       INFILE = 'etc/';

   ```

   返回结果如下：

   ```

### CHECK MODULE DATA 示例

#### 注意

当前版本仅支持检查（`CHECK MODULE DATA`）导入的 `REDIS` 模块功能。

- 未向租户导入功能时，执行 `CHECK MODULE DATA` 语句将会报错。检查租户 `mysql002` 导入 `REDIS` 模块功能情况。

  ```sql
  ALTER SYSTEM CHECK MODULE DATA
      MODULE = REDIS
      TENANT = mysql002;

  ```

  返回结果如下：

  ```shell
  ERROR 4025 (HY000): redis info is not complete，please retry loading

  ```
 - 先向租户导入功能后，再检查导入功能情况。

     1. 向租户 `mysql002` 导入 `REDIS` 模块功能。

       ```sql
       ALTER SYSTEM LOAD MODULE DATA
           MODULE = REDIS
           TENANT = 'mysql002';

       ```

       返回结果如下：

       ```
     2. 检查租户 `mysql002` 导入 `REDIS` 模块功能情况。

       ```

       返回结果如下：

       ```

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