---
title: "快速入门 | OceanBase 文档中心"
description: 快速入门 本文档旨在指导用户如何快速使用导数工具。 步骤 1：下载软件 说明 导数工具 4.2.1 及之后的版本不再区分企业版和社区版。用户可以从社区下载中心获取软件包。 下载 最新版本的导数工具软件包并解压： $ unzip ob-loader-dumper-4.2.1-RELEASE.zip $ cd ob-lo…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*eAudSaxX8P0AAAAAAAAAAAAADiGDAQ/original) 导数工具V 4.2.1 社区版

# 快速入门

更新时间：2023-07-03 14:19:40

[编辑](https://github.com/oceanbase/obdumper-loader-doc/edit/V4.2.1/zh-CN/300.quick-start.md)  

本文档旨在指导用户如何快速使用导数工具。

## 步骤 1：下载软件

#### 说明

导数工具 4.2.1 及之后的版本不再区分企业版和社区版。用户可以从社区下载中心获取软件包。

[下载](https://www.oceanbase.com/softwarecenter?_gl=1*nejld*_ga*NDQ5MTc4NTEuMTY3NTIzOTgyOA..*_ga_T35KTM57DZ*MTY4Mzg1ODgwNC44MC4xLjE2ODM4NTg4NTYuOC4wLjA.)最新版本的导数工具软件包并解压：

```shell
$ unzip ob-loader-dumper-4.2.1-RELEASE.zip
$ cd ob-loader-dumper-4.2.1-RELEASE

```

## 步骤 2：配置运行环境

#### 说明

用户的本地环境中必须安装 Java 8+ 并配置 `JAVA_HOME` 环境变量。强烈建议安装 JDK 1.8.0_3xx 及之后的版本。环境配置详情请参考 [准备环境](https://www.oceanbase.com/docs/community-obloaderdumper-cn-10000000002035963)。

本步骤旨在修改 JVM 参数。

JVM 内存太小可能会影响导入导出的性能，甚至影响导入导出功能的稳定性。例如：Full GC 或者 GC Crash。强烈建议将 JVM 内存 (默认：-Xms4G -Xmx4G) 修改为机器可用内存的 60%。擅长 Java 性能调优的用户可以按需调整 `JAVA_OPTS` 选项中的 JVM 参数。

1. 编辑 `JAVA_OPTS` 选项所在的文件。

      - Linux 操作系统下，编辑 `{ob-loader-dumper}/bin/` 目录下的 `obloader` 和 `obdumper` 脚本。
      - Windows 操作系统下，编辑 `{ob-loader-dumper}/bin/windows/` 目录下的 `obloader.bat` 和 `obdumper.bat` 脚本。
 2. 修改 JVM 参数。

   ```shell
   JAVA_OPTS="$JAVA_OPTS -server -Xms4G -Xmx4G -XX:MetaspaceSize=128M -XX:MaxMetaspaceSize=128M -Xss352K"
   JAVA_OPTS="$JAVA_OPTS -XX:+UnlockExperimentalVMOptions -XX:+UseG1GC -Xnoclassgc -XX:+DisableExplicitGC

   ```

## 步骤 3：准备数据

#### 注意

试用 OBDUMPER 导出功能时，用户无需准备任何数据，可以直接跳转到**步骤 4**。

试用 OBLOADER 导入功能时，用户可以使用已有的数据文件，或者使用 TPC-H 工具临时生成数据文件。导入的文件内容格式需要符合规范，请参考[《准备好您的数据了吗？》](https://open.oceanbase.com/blog/1100272)识别文件中的数据格式。

## 步骤 4：创建数据库

#### 注意

试用 OBDUMPER 导出功能时，用户需要在创建数据库以后，继续创建表并插入数据。

1. 使用 OCP 管控平台或者 OBD 命令行工具搭建 OceanBase 集群。
 2. 创建测试数据库。
 3. 创建测试表并插入数据。（导入时可选）

## 步骤 5：导入和导出数据

### 导入数据示例

```shell
./obloader -h 'IP地址' -P'端口' -u'用户' -t'租户' -c'集群' -p'密码' -D'库名' --table '表名' --csv -f '文件路径' --sys-password '系统租户密码' --external

```

#### 说明

本示例仅导入数据不包含模式。更多详情请参考 [OBLOADER 命令行选项](https://www.oceanbase.com/docs/community-obloaderdumper-cn-10000000002041311)。

### 导出数据示例

```shell
./obdumper -h 'IP地址' -P'端口' -u'用户' -t'租户' -c'集群' -p'密码' -D'库名' --table '表名' --csv -f '文件路径' --sys-password '系统租户密码' --skip-check-dir

```

#### 说明

本示例仅导出数据不包含模式。更多详情请参考 [OBDUMPER 命令行选项](https://www.oceanbase.com/docs/community-obloaderdumper-cn-0000000002367609)。

## 步骤 6：恭喜！

您已成功完成导数工具的快速试用！！！

如需了解更多信息，请参考以下步骤进行学习：

- 阅读产品简介，了解导数工具的原理，主要功能，及与其它工具的差异。想要更详细地理解导数工具，请参考官方文档[《OceanBase 导数工具》](https://www.oceanbase.com/docs/oceanbase-dumper-loader-cn)。
 - 欢迎加入 [OceanBase 社区](https://open.oceanbase.com/?_gl=1*dqbsdn*_ga*NDQ5MTc4NTEuMTY3NTIzOTgyOA..*_ga_T35KTM57DZ*MTY4Mzg1ODgwNC44MC4xLjE2ODM4NTg4ODUuNjAuMC4w)，我们一起和 OceanBase 的研发人员在线上讨论导入导出的问题、需求，以及对于未来的规划。

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