---
title: "导出结构和数据 - 开发者中心 ODC V4.4.2 | OceanBase 文档中心"
description: 导出结构和数据 背景信息 ODC 支持批量导出数据库对象的结构和数据。 通过 ODC 导出任务可以分别导出数据库对象的结构和数据、仅导出数据或者仅导出结构。 导出结构和数据：同时导出数据库对象的定义语句及其数据。 仅导出数据：仅导出表/视图对象的数据。 仅导出结构：仅导出数据库对象的定义语句。 导出文件格式 ODC …
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lqS5SYzz_YEAAAAAAAAAAAAADiGDAQ/original) 开发者中心 ODCV 4.4.2

# 导出结构和数据

更新时间：2026-04-27 17:33:32

[编辑](https://github.com/oceanbase/odc-doc/edit/V4.4.2/zh-CN/700.tickets-management/200.export-data.md)  

## 背景信息

ODC 支持批量导出数据库对象的结构和数据。

通过 ODC 导出任务可以分别导出数据库对象的结构和数据、仅导出数据或者仅导出结构。

- 导出结构和数据：同时导出数据库对象的定义语句及其数据。
 - 仅导出数据：仅导出表/视图对象的数据。
 - 仅导出结构：仅导出数据库对象的定义语句。

## 导出文件格式

ODC 导出工具会将导出数据到以 .zip 结尾的压缩文件包中，压缩包中包含元数据文件 MANIFEST.bin 和 Schema 下导入导出对象的结构定义文件和数据文件。

创建导出任务时，如果您指定 **数据格式** 为 **SQL 格式**，那文件包中的结构定义文件是以 `对象名-schema.sql` 命名的 SQL 文本，数据文件是以 `对象名.sql` 命名的 SQL 文本，其中对象名与数据库实际对象名保持一致。

![Image 445](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/2671938161/p263147.png)

如果您指定 **数据格式** 为 **CSV 格式**，那文件包中的结构定义文件是以 `对象名-schema.sql` 命名的 SQL 文本，数据文件是以 `对象名.csv` 命名的 CSV 文本，其中对象名与数据库实际对象名保持一致。

![Image 444](https://help-static-aliyun-doc.aliyuncs.com/assets/img/zh-CN/3671938161/p263148.png)

## 注意事项

- ODC 对导出的数据大小有限制，Web 版 ODC 最大支持导出 2GB 的数据（压缩前）超出部分无法导出。如需导出大量数据，请使用导数工具 [OBDUMPER](https://www.oceanbase.com/docs/common-oceanbase-dumper-loader-1000000000246581)。
 - 最大支持 5 个导出任务并行运行，后续任务在队列中等待运行。
 - 导出任务涉及的文件默认保留 14 天。
 - OceanBase V4.0.0 及之前版本的数据源中配置 sys 租户账号和密码可以提升导出速度。ODC 通过分区位置可以计算最佳的导数并行策略，OceanBase V4.0.0 及之前版本需要通过 sys 租户查询和确定分区位置。
 - OceanBase V4.0.0 之后版本的数据源中无需配置 sys 租户账号和密码，ODC 支持通过业务租户的视图查询和确定分区位置。

## 新建导出任务

#### 说明

ODC V4.2.3 及之后版本支持导出 MySQL 类型的数据库结构和数据，V4.2.4 及之后版本支持导出 Oracle 类型的数据库结构和数据

1. 在 **工单** 页签中单击 **导出** > **新建导出**。

   ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/Import-and-export/export-data-1.png)
 2. 在导出页面中，输入以下信息，并单击 **下一步：导出设置**。

   ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/Import-and-export/export-data-2.png)

   | 信息项 | 说明 |
   | --- | --- |
   | 导出内容 | 选择导出内容的格式，支持选择 **导出结构和数据**/**仅导出数据**/**仅导出结构**。 |
   | 数据库 | 选择导出对象所在的数据库。 |
   | 导出范围 | 支持选择 **部分导出** 和 **整库导出**。    - 部分导出：在 **导出对象** 的 **选择对象** 窗口中勾选需要导出的对象。支持使用搜索框直接进行搜索对象。   - 整库导出：导出当前库中的所有对象。 |
 3. 填写导出设置内容，并单击 **导出**。

   ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/Import-and-export/export-data-3.png)

      1. 设置数据文件。

        #### 说明

        当 **导出内容** 为仅导出结构时无需设置数据文件。

        | **设置项** | **说明** |
        | --- | --- |
        | 数据格式 | ODC 目前支持将数据导出为 **CSV 格式** 和 **SQL 格式** 。当 **导出内容** 为 **仅导出结构** 时，只支持导出数据为 SQL 格式。 |
        | 文件编码 | ODC 目前支持 **ASCII**、**ISO-8859-1**、**GB2312**、**GBK**、**GB18030**、**Unicode（UTF-8）**、**Unicode（UTF-16）**、**Unicode（UTF-32）** 和 **BIG5** 等编码格式。 |
        | 单个文件上限 | 当 **导出内容** 为仅导出结构时无需进行单个文件上限设置。   支持选择导出的单表数据文件上限。文件大小超过上限后，文件将自动切分；若选择不限制，则不切分文件。 |
        | CSV 设置 | 选择导出 CSV 格式且 **导出内容** 为导出结构和数据时，可指定以下信息：      - **包含列头**：该项默认勾选，选择导出数据为 CSV 格式时是否包含列头。     - **空字符串转为空值**：该项默认勾选，选择导出数据为 CSV 格式时是否将表中的空字符串转换为空值 \N。     - **字段分隔符**：设置字段间的分隔符。支持选择 **,** （逗号）、 **;** （分号）和 **:** （冒号）作为字段分割符。同时支持自定义一个字符长度的字符作为分隔符。     - **文本识别符**：设置文本内容的识别符。支持选择 **'** （单引号）和 **"** （双引号）作为文本识别符。     - **换行符号**：设置换行符。支持选择 **\n**、**\r** 和 **\r\n** 作为换行符。 |
        | 批量提交数量（SQL 格式） | 选择导出 SQL 格式数据时，通过指定批量提交数量，可在导出文件中导出指定数量数据时添加一句 `COMMIT` 命令。 |
        | 使用全局快照 | 勾选该项后 ODC 将导出全局中指定表的最新快照点中的数据，勾选该项可以保证全局数据的一致性。 |
      2. 设置结构文件。

             - 当 **导出内容** 为仅导出结构时，支持选择是否 **导出结果合并为一个 SQL 文件**。勾选该项后，会合并 DDL 并导出为一个 SQL 文件。
             - 在该项下选择是否在 **Create 语句前添加 Drop 语句** 。勾选该项后，在导出对象结构文件时，在对象的 `CREATE` 语句前均会添加对应的 `DROP` 语句。
      3. 设置任务执行方式。

        选择执行方式 **手动执行**/**立即执行** / **定时执行**。
      4. 填写描述。
      5. 保留当前配置。

        指定所有信息后，勾选面板左下角的 **保留当前配置** 以保留当前部分数据文件和结构文件配置。
 4. 任务生成后可以在 **工单** > **导出** 列表中查看任务信息。

   ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/Import-and-export/export-data-4.png)

## 查看导出任务

1. 访问 **工单** > **导出**，导出任务列表中，单击目标任务的名称，查看任务详情。也可以通过操作列的 ··· 对目标任务进行更多操作。

      - 执行：当任务执行方式为手动执行时，主动执行该工单。
      - 终止：当任务执行方式为周期执行或定期执行时，可通过终止结束该工单。勾选目标工单，可通过上方的批量操作按钮进行批量终止。
      - 编辑：当任务状态为禁用时，可通过编辑对该任务内容进行更新。
      - 删除：当任务状态为已完成或终止时，可通过删除对该任务进行删除操作。
      - 查看：查看任务内容详情。
      - 克隆：复制该任务执行内容，快速生成相同配置的新建任务界面。
      - 分享：快速复制该任务的访问地址。
      - 下载：下载创建的模拟数据到本地磁盘，用户可以从本地磁盘中查看导出的数据结构文件。

   ![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/Import-and-export/export-data-4.png)
 2. 在弹出的任务详情面板中，默认展示该作业的 **基本信息** 页签，可以查看任务类型、数据库、变量配置、执行方式等信息。

   #### 说明

   您可以在系统设置中对查询结果是否支持查询和下载进行配置，详情请参见 [系统设置](https://www.oceanbase.com/docs/common-odc-1000000005551379)。

   ![5](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/Import-and-export/export-data-5.png)
 3. 单击 **任务流程** 页签查看发起任务状态、审批状态、执行状态和执行结果等信息。

   ![6](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/Import-and-export/export-data-6.png)
 4. 单击 **任务日志** 页签查看任务的全部日志和告警日志。

   | 信息项 | 说明 |
   | --- | --- |
   | 全部日志 | 全部日志显示任务的 **INFO**、**ERROR** 和 **WARN** 日志等全量信息。 单击 **查找**、**下载** 和 **复制** 按钮，可查找信息、下载或复制全部日志信息。 |
   | 告警日志 | 告警日志单独显示任务的 **ERROR** 和 **WARN** 日志。当任务失败时，可通过告警日志查看错误信息。 单击 **查找**、**下载** 和 **复制** 按钮，可查找信息、下载或复制告警日志信息。 |

   ![7](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/Import-and-export/export-data-7.png)

## 相关文档

- [导入数据](https://www.oceanbase.com/docs/common-odc-1000000005551405)

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