导入结构和数据

背景信息

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。

• 最大支持 5 个导入任务并行运行，后续任务在队列中等待运行。

• 导入任务涉及的文件默认保留 14 天。

• OceanBase V4.0.0 及之前版本的数据源中配置 sys 租户账号和密码可以提升导入速度。ODC 通过分区位置可以计算最佳的导数并行策略，OceanBase V4.0.0 及之前版本需要通过 sys 租户查询和确定分区位置。

• OceanBase V4.0.0 之后版本的数据源中无需配置 sys 租户账号和密码，ODC 支持通过业务租户的视图查询和确定分区位置。

新建导入任务

导入 OceanBase 数据库结构和数据

示例：将本地磁盘中表 employee 和 salary 的结构和数据批量导入到数据库 odc_test 中。

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

   

2. 在弹出的任务面板中，选择导入文件格式。

   

   说明

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

3. 上传导入文件。

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

4. 选择文件编码。

   ODC 目前支持 ASCII 、 ISO-8859-1 、 GB2312 、 GBK 、 GB18030 、 Unicode（UTF-8） 、 Unicode（UTF-16） 、 Unicode（UTF-32） 和 BIG5 等编码格式。

5. 进入导入设置面板。

   单击 下一步：导入设置 对导入的文件进行设置。

6. 选择导入内容。

   

   说明

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

7. 选择所属库。

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

8. 设置导入数据。

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

   • 导入前清空数据 ：勾选该项后，导入数据时将首先清空目标对象中原有的数据。

   • 批量提交数量 ：单击 导入数据设置 标签后的 高级 按钮，在弹出的列表中可指定该项。通过指定批量提交数量，可在导入文件中导入指定数量数据时添加一句 COMMIT 命令。

   • 不导入的数据类型 （可选）：可以通过该项指定导入数据时要跳过的数据类型。MySQL 和 Oracle 下可跳过的类型不同，支持多选。

9. 设置导入结构。

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

10. 设置任务错误处理和执行方式。

    • ODC 提供 停止任务 和 忽略错误继续任务 两种错误处理方式。需要在 任务错误处理 标签下选择需要的处理方式。

    • 支持选择 立即执行 / 定时执行 。

11. 保留当前配置。

    指定所有信息后，勾选面板左下角的 保留当前配置 以保留当前部分数据文件和结构文件配置。

12. 生成导入任务。

    指定所有信息后，单击面板右下角的 提交 按钮以生成导入任务。

13. 查看导入任务。

    任务生成后会自动弹出 任务中心 面板，在任务中心可以查看任务信息。

导入 MySQL 数据库结构和数据

示例：将本地磁盘中表 employee 和 salary 的结构和数据批量导入到数据库 odc_test 中。

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

   

2. 在弹出的任务面板中，选择导入文件格式。

   

   说明

   • ODC 目前支持批量导入 CSV 文件、 SQL 文件 和 ZIP 压缩文件。
   • 导入文件格式为 CSV 文件时，支持跳过首行字段列头字段。
   • 导入文件格式为 ZIP 压缩文件时，支持导入单表或者多表和跳过已存在的结构。

3. 上传导入文件。

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

4. 选择文件编码。

   ODC 目前支持 ASCII 、 ISO-8859-1 、 GB2312 、 GBK 、 GB18030 、 Unicode（UTF-8） 、 Unicode（UTF-16） 、 Unicode（UTF-32） 和 BIG5 等编码格式。

5. 进入导入设置面板。

   单击 下一步：导入设置 对导入的文件进行设置。

6. 选择导入内容。

   

   说明

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

7. 选择所属库。

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

8. 设置导入数据。

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

   • 导入前清空数据 ：勾选该项后，导入数据时将首先清空目标对象中原有的数据。

   • 批量提交数量 ：单击 导入数据设置 标签后的 高级 按钮，在弹出的列表中可指定该项。通过指定批量提交数量，可在导入文件中导入指定数量数据时添加一句 COMMIT 命令。

9. 设置导入结构。

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

10. 设置任务错误处理和执行方式。

    • ODC 提供 停止任务 和 忽略错误继续任务 两种错误处理方式。需要在 任务错误处理 标签下选择需要的处理方式。

    • 支持选择 立即执行 / 定时执行 。

11. 保留当前配置。

    指定所有信息后，勾选面板左下角的 保留当前配置 以保留当前部分数据文件和结构文件配置。

12. 生成导入任务。

    指定所有信息后，单击面板右下角的 提交 按钮以生成导入任务。

13. 查看导入任务。

    任务生成后会自动弹出 任务中心 面板，在任务中心可以查看任务信息。

导入 Oracle 数据库结构和数据

示例：将本地磁盘中表 employee 和 student 的结构和数据批量导入到数据库 ODC_TEST 中。

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

   

2. 在弹出的任务面板中，选择导入文件格式。

   

   说明

   • ODC 目前支持批量导入 CSV 文件、 SQL 文件 和 ZIP 压缩文件。
   • 导入文件格式为 CSV 文件时，支持跳过首行字段列头字段。
   • 导入文件格式为 ZIP 压缩文件时，支持导入单表或者多表和跳过已存在的结构。

3. 上传导入文件。

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

4. 选择文件编码。

   ODC 目前支持 ASCII 、 ISO-8859-1 、 GB2312 、 GBK 、 GB18030 、 Unicode（UTF-8） 、 Unicode（UTF-16） 、 Unicode（UTF-32） 和 BIG5 等编码格式。

5. 进入导入设置面板。

   单击 下一步：导入设置 对导入的文件进行设置。

6. 选择导入内容。

   

   说明

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

7. 选择所属库。

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

8. 设置导入数据。

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

   • 导入前清空数据 ：勾选该项后，导入数据时将首先清空目标对象中原有的数据。

   • 批量提交数量 ：单击 导入数据设置 标签后的 高级 按钮，在弹出的列表中可指定该项。通过指定批量提交数量，可在导入文件中导入指定数量数据时添加一句 COMMIT 命令。

   • 不导入的数据类型（可选）：支持不导入 BLOB 和 CLOB 数据类型。

9. 设置导入结构。

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

10. 设置任务错误处理和执行方式。

    • ODC 提供 停止任务 和 忽略错误继续任务 两种错误处理方式。需要在 任务错误处理 标签下选择需要的处理方式。

    • 支持选择 立即执行 / 定时执行 。

11. 保留当前配置。

    指定所有信息后，勾选面板左下角的 保留当前配置 以保留当前部分数据文件和结构文件配置。

12. 生成导入任务。

    指定所有信息后，单击面板右下角的 提交 按钮以生成导入任务。

13. 查看导入任务。

    任务生成后会自动弹出 任务中心 面板，在任务中心可以查看任务信息。

    

查看导入任务

任务列表

导入任务生成后会自动弹出 工单 面板，在 导入 列表中可以查看任务审批状态、任务信息和任务日志。

导入 任务列表中包含如下信息：

任务信息

1. 如上图所示，在 导入 任务列表中单击 查看 按钮。

2. 弹出目标任务的任务详情面板，单击 任务信息 标签查看任务基本信息、导入文件信息和导入对象信息。

   

   信息项	说明
   任务基本信息	显示执行状态、任务编号 、 所属数据库、 任务类型、风险等级、执行方式、创建人 和 创建时间 等信息。
   导入文件信息	显示创建导入任务时选择的 导入文件格式、 导入文件、 文件编码、 数据格式 和 任务错误处理 等信息。
   导入对象信息	显示该任务中您选择的对象在导入数据时的完成情况，包括 对象名称、 对象类型、实际处理数量 和 数据处理状态 等信息。

任务流程

在目标任务的任务详情面板中，单击 任务流程 标签查看 发起任务 、 审批 和 执行 状态等信息。

任务日志

在目标任务的任务详情面板，单击 任务日志 标签查看任务的全部日志和告警日志。

同时，工具栏提供了以下功能键：

相关文档

• 导出数据