---
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-26 20:37:09

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

## 背景信息

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

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

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

## 导入文件格式

ODC 导入工具支持导入 ZIP 压缩文件（批量导入和单表导入）、SQL 文件（批量导入）和 CSV 文件（单表导入）。

其中，ZIP 压缩文件是以 .zip 结尾的压缩包。创建导入任务时在面板中的 **导入内容** 项中选择了 **ZIP 压缩文件** 后还需在 **数据格式** 项中选择压缩包中的数据格式是 **CSV 格式** 或 **SQL 格式** 。

批量导入时支持导入 SQL 文件，SQL 文件是以 .sql 结尾包含可直接在数据库中执行的 `SELECT`、`INSERT`、`UPDATE`、`DELETE`、`CREATE` 和 `DROP` 语句的文件。

单表导入时支持导入 CSV 文件，CSV 文件是 .csv 或 .txt 结尾的支持自定义分割符的数据文件。

## 注意事项

- Web 版 ODC 对导入上传的文件大小有限制，最大支持导入 2GB（压缩后）的文件，超出部分无法上传。如需导入大量数据，请使用导数工具 [OBLOADER](https://www.oceanbase.com/docs/common-oceanbase-dumper-loader-1000000000246590)。
 - 最大支持 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/import-data-1.png)
 2. 在弹出的任务面板中，填写导入文件信息。

      1. 选择导入文件格式。

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

        #### 说明

             - ODC V4.2.3 及之后版本支持导入 MySQL 类型数据库结构和数据。
             - ODC 目前支持批量导入 **CSV 文件**、**SQL 文件** 和 **ZIP 压缩文件**。
             - **导入文件格式**为 CSV 文件时，支持跳过首行字段列头字段。
             - **导入文件格式**为 ZIP 压缩文件时，支持导入单表或者多表和跳过已存在的结构。
      2. 上传导入文件。

        单击文件池进入文件资源管理器以选择需要导入的文件，或者直接将文件拖入文件池中以完成文件上传。上传的文件格式需要与所选择的导入文件格式相同，ZIP 压缩文件支持上传 .zip 结尾的文件、SQL 文件支持上传 .sql 文件以及 CSV 文件支持上传 .csv 文件。

        ![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/441/Import-and-export/import-data-3.png)
      3. 选择文件编码。

        ODC 目前支持 **ASCII**、**ISO-8859-1**、**GB2312**、**GBK**、**GB18030**、**Unicode（UTF-8）**、**Unicode（UTF-16）**、**Unicode（UTF-32）** 和 **BIG5** 等编码格式。
 3. 单击 **下一步：导入设置**，对导入文件进行以下配置，并单击 **提交**。

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

      1. 选择导入内容。

        #### 说明

             - 当 **导入格式** 为 ZIP 压缩文件时需指定该项。
             - ODC 目前支持 **仅导入数据**、**仅导入结构** 和 **导入数据和结构** 三种方式。其中导入结构指是否要导入对象的定义语句。
      2. 选择所属库。

        选择导入对象所在的数据库。该项下同时显示目标任务所在数据库的数据源名称。
      3. 设置导入数据。

        当 **导入格式** 为 ZIP 压缩文件且 **导入内容** 不为仅导入结构时需设置导入数据。该项包含以下设置项：

             - **导入前清空数据**：勾选该项后，导入数据时将首先清空目标对象中原有的数据。
             - **批量提交数量**：单击 **导入数据设置** 标签后的 **高级** 按钮，在弹出的列表中可指定该项。通过指定批量提交数量，可在导入文件中导入指定数量数据时添加一句 `COMMIT` 命令。
             - **不导入的数据类型** （可选）：可以通过该项指定导入数据时要跳过的数据类型。MySQL 和 Oracle 下可跳过的类型不同，支持多选。
      4. 设置导入结构。

        当 **导入内容** 为仅导入数据时，该项不可被指定。在该项下选择当对象结构已存在时的操作。选择 **跳过** 操作则在导入时跳过导入文件中的结构定义语句直接导入数据，该项会保留对象中的原数据。选择 **替换** 操作时则执行导入文件中的结构定义语句以重新创建并替换原对象，该项会清空对象中的原数据。
      5. 任务设置。

             - 任务错误处理：ODC 提供 **停止任务** 和 **忽略错误继续任务** 两种错误处理方式。需要在 **任务错误处理** 标签下选择需要的处理方式。
             - 执行方式：支持选择 **立即执行** / **定时执行** 。
      6. 填写描述。
      7. 保留当前配置。

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

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

## 查看导入任务

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

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

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

   #### 说明

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

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

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

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

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

## 相关文档

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

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