--- title: DBCat 工具从部署到实践-OceanBase数据库使用指南 description: 了解OceanBase数据库在实际应用中关于DBCat 工具从部署到实践相关的常见问题和使用技巧，帮助您快速解决DBCat 工具从部署到实践的难题。 --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 划线反馈 # DBCat 工具从部署到实践 更新时间：2026-05-29 09:46 适用版本： V2.2.x、V3.1.x、V3.2.x、V4.0.x、V4.1.x、V4.2.x 内容类型：TechNote 本文主要详细介绍 DBCat 工具的安装部署与实践。 ## 适用版本 OceanBase 数据库 V2.X 及后续版本。 DBCat 工具的最新版本。 ## JDK 1.8 部署 1. JDK 1.8 的下载地址：https://www.oracle.com/java/technologies/downloads/。 2. 创建一个 java 目录来存放 java 文件。 ![dbcat](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/OMS/imgN7ucYqHuC5.png) 3. 执行如下命令将下载好的 java 文件存放到 `/usr/java/` 目录并进行解压。 ```shell tar -zxvf jdk-8u241-linux-x64.tar.gz #会生成jdk1.8.0_241 目录 ``` ![dbcat](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/OMS/imgJrbIJM2eeK.png) 4. 配置环境变量。 ```shell vim /etc/profile ``` 将如下内容添加到 `/etc/profile` 文件中。 ```shell export JAVA_HOME=/usr/java/jdk1.8.0_241（您的JDK 版本和java目录） export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib export PATH=$JAVA_HOME/bin:$PATH source /etc/profile #让文件立即生效 ``` 5. 输入 `java -version` 命令进行测试 java 安装成功情况，已经安装成功。 ![dbcat](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/OMS/img6J24G2kEcP.png) ## DBCat 部署 1. DBCat 安装包请联系技术支持人员获取。 2. 创建一个 `/dbcat` 目录用于存放下载好的 DBCat 安装包。 ![dbcat](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/OMS/imgvVqWfjZFrZ.png) ​ 3. 解压 DBCat。 ```shell tar -zxvf dbcat-1.9.1-RELEASE.tar.gz #会生成 dbcat-1.9.1-RELEASE 目录 cd dbcat-1.9.1-RELEASE/bin/ ./dbcat --version #查看dbcat版本 1.9.1-RELEASE ``` ![dbcat](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/OMS/imgUn5lmWcHUO.png) ## DBCat 实践 以导出原生 Oracle 11g 的 Schema 为例。 1. 导出库中全部内容。 ```shell ./dbcat convert -H 127.1 -P 1521 -u test2 -p xxx --service-name helowin -D TEST2 --from oracle11g --to oboracle322 --all ``` 2. 导出库中 table。 ```shell ./dbcat convert -H 127.1 -P 1521 -u test2 -p xxx --service-name helowin -D TEST2 --from oracle11g --to oboracle322 --table=TABLE1,TABLE2,... ``` 3. 导出库中 sequence。 ```shell ./dbcat convert -H 127.1 -P 1521 -u test2 -p xxx --service-name helowin -D TEST2 --from oracle11g --to oboracle322 --sequence=SEQ1,SEQ2,... ``` 4. 导出库中 procedure。 ```shell ./dbcat convert -H 127.1 -P 1521 -u test2 -p xxx --service-name helowin -D TEST2 --from oracle11g --to oboracle322 --procedure=PRO1,PRO2,... ``` 5. 导出库中 type。 ```shell ./dbcat convert -H 127.1 -P 1521 -u test2 -p xxx --service-name helowin -D TEST2 --from oracle11g --to oboracle322 --type=TYPE1,TYPE2,... ``` 6. 导出库中 function。 ```shell ./dbcat convert -H 127.1 -P 1521 -u test2 -p xxx --service-name helowin -D TEST2 --from oracle11g --to oboracle322 --function=FUN1,FUN2,... ``` 7. 查看帮助。 ```shell ./dbcat help convert ``` 8. 目前 --to 所支持的类型及版本如下，其他未列出版本暂不支持。 - 转换成 OceanBase 数据库 V3.2.2 版本 Oracle 模式。 ``` - 转换成 OceanBase 数据库 V2.2.77 版本 Oracle 模式。 ```shell ./dbcat convert -H 127.1 -P 1521 -u test2 -p xxx --service-name helowin -D TEST2 --from oracle11g --to oboracle2277 --all ``` ![dbcat](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/OMS/imgEmwDlpWf7u.png) ![dbcat](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/OMS/imgaiCqwxoEZ9.png) 9. 参数详解如下。 | 参数 | 说明 | | --- | --- | | -H | 主机地址 IP | | -P | Oracle 数据库的端口号 | | -u | 连接数据库的用户名 | | -p | 连接数据库的密码 | | --server-name | 连接 Oracle 数据库需要提供服务名 | | -D | 连接的数据库名 | | --from | Oracle 数据库版本 | | --to | 转换成 OceanBase 数据库版本 | 上一篇 [mysqldump 工具导出数据错误，错误代码 1109](https://www.oceanbase.com/knowledge-base/oceanbase-database-20000000193) 下一篇 [DBCat 如何使用 Compare 功能](https://www.oceanbase.com/knowledge-base/oceanbase-database-20000000030) ![有帮助](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) 咨询热线