--- title: "使用 DBCAT 迁移 Oracle 表结构到 OceanBase 数据库 - OceanBase 数据库 V4.6.0 | OceanBase 文档中心" description: "使用 DBCAT 迁移 Oracle 表结构到 OceanBase 数据库 DBCAT 是一款轻量级的命令行工具，可用于提供数据库之间 DDL 转换和 Schema 比对等功能。这里以 DBCAT 迁移表结构为示例进行介绍。 DBCAT 安装包文件名为 dbcat-[版本号]-SNAPSHOT.tar.gz ，下载后…" --- 切换语言 - 中文站 - 简体中文 - International - English - 日本站 - 日本語 文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.6.0 # 使用 DBCAT 迁移 Oracle 表结构到 OceanBase 数据库 更新时间：2026-07-01 15:16:54 [编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.6.0/zh-CN/500.data-migration/400.migrate-data-from-oracle-database-to-oceanbase-database/100.use-dbcat-to-migrate-data-from-oracle-database-to-oceanbase-database.md) DBCAT 是一款轻量级的命令行工具，可用于提供数据库之间 DDL 转换和 `Schema` 比对等功能。这里以 DBCAT 迁移表结构为示例进行介绍。 DBCAT 安装包文件名为 `dbcat-[版本号]-SNAPSHOT.tar.gz`，下载后解压缩即可使用，可执行文件名为 `dbcat`。 #### 注意 DBCAT 是 OMS 的一个组件，在社区版环境中推荐使用 OMS 导出。 ## 环境准备 DBCAT 能运行在 CentOS、macOS 和 Windows 下。需要安装 `JDK 1.8` 以上（含）版本。可以使用 `OpenJDK`，安装好后配置环境变量 `JAVA_HOME`。 CentOS 安装 `OpenJDK` 示例： ```shell $sudo yum -y install java-1.8.0-openjdk.x86_64 $which java /usr/local/java/jdk1.8.0_261/bin/java echo 'export JAVA_HOME=/usr/local/java/jdk1.8.0_261/' >> ~/.bash_profile . ~/.bash_profile ``` 解压安装文件： ```shell tar zxvf dbcat-1.8.0-SNAPSHOT.tar.gz cd dbcat-1.8.0-SNAPSHOT/ chmod +x bin/dbcat $tree -L 3 --filelimit 30 . ├── bin │ ├── dbcat │ ├── dbcat.bat │ └── dbcat-debug ├── conf │ ├── dbcat.properties │ └── logback.xml ├── docs │ ├── README.docx │ ├── README.md │ └── README.txt ├── LEGAL.md ├── lib [45 entries exceeds filelimit, not opening dir] ├── LICENSE ├── meta │ └── README └── NOTICE 5 directories, 12 files ``` 安装文件中有以下几个目录需要了解： | 目录名 | 说明 | | --- | --- | | bin | 可执行文件目录。 | | conf | 日志文件配置目录。 | | lib | 运行时期依赖的包。 | | meta | 离线转换场景下，导出字典表数据。 | | ~/output | SQL 文件与报告文件，运行时生成。 | ## 导出 Oracle 数据库的表结构 DBCAT 具有在线转换功能，该功能是指 DBCAT 能直连源端数据库，将数据库中的对象导出。当对象非常多时（如超过 1 万），导出过程可能会有点慢。 dbcat 导出命令如下： ```shell bin/dbcat convert -H -P -u -p<******> -D --service-name --service-id --from --to --all ``` 您可运行命令 `bin/dbcat help convert` 查看更多参数信息。 必选参数： | 选项 | 有无参数 | 中文描述 | | --- | --- | --- | | -H/--host | Y | 数据库服务器的 IP 地址 | | -P/--port | Y | 数据库服务器的端口 | | -u/--user | Y | 登录数据库的用户名 | | -t/--tenant | Y | 连接 OceanBase 集群需要提供租户名 | | -c/--cluster | Y | 连接 OceanBase 集群需要提供集群名 | | -p/--password | Y | 登录数据库的密码 | | -D/--database | Y | 数据库名（源库），DB2 须区分数据库名和模式名 | | --service-id | Y | 连接 Oracle 数据库需要提供服务 ID | | --service-name | Y | 连接 Oracle 数据库需要提供服务名 | | --as-sysdba | N | 连接 Oracle 数据库 sysdba 角色 | | --sys-user | Y | 连接 OceanBase 集群系统租户的用户名 | | --sys-password | Y | 连接 OceanBase 集群系统租户的密码 | | --schema | Y | 模式名（源库），非DB2，模式名与数据名相同 | | --from | Y | 源库的类型 | | --to | Y | 目标库的类型 | | --all | N | 所有的数据库对象 | 可选参数： | 选项 | 有无参数 | 中文描述 | | --- | --- | --- | | -f/--file | Y | sql 文件的输出路径 | | --offline | N | 使用离线模式 | | --target-schema | Y | 模式名（目标库） | | --table | Y | 导出的表 | | --view | Y | 导出的视图 | | --trigger | Y | 导出的触发器 | | --synonym | Y | 导出的同义词 | | --sequence | Y | 导出的序列 | | --function | Y | 导出的函数 | | --procedure | Y | 导出的存储过程 | | --dblink | Y | 导出所有的 DBLink | | --type | Y | 导出的 type | | --type-body | Y | 导出的 type body | | --package | Y | 导出的 package | | --package-body | Y | 导出的 package body | | --no-quote | N | 产生的 DDL 不带引号 | | --no-schema | N | 产生的 DDL 不带模式名 | | --target-schema | Y | 产生的 DDL 中使用指定的模式名 | | --exclude-type | Y | 搭配 --all 使用，如：--all --exclude-type 'TABLE' 表示排除 TABLE 类型 | 这里以导出 Oracle 12c 版本下 database 为 test 的所有对象的结构，并将其迁移到 4.0.0 版本的 OceanBase 集群中的 Oracle 租户为示例。 ```shell bin/dbcat convert -H 100.88.xxx.xxx -P 1521 -uxxx -pxxxxxx -D test --service-name xxx --service-id xxx --from oracle12c --to oboracle40 --all ``` 特别说明： - dbcat 不需要直接安装在数据库主机上，安装在可直连数据库主机的主机上即可。 - 参数中的 --from 和 --to 为源端和目的端的数据库类型，需要详细到版本号。当前 dbcat 支持的源端和目标端数据库详细如下： | 源端数据库类型 | 目标端数据库类型 | | --- | --- | | TiDB | OBMYSQL | | PG | OBMYSQL | | SYBASE | OBORACLE | | MYSQL | OBMYSQL | | ORACLE | OBORACLE | | ORACLE | OBMYSQL | | DB2 IBM i | OBORACLE | | DB2 LUW | OBORACLE | | DB2 LUW | OBMYSQL | | OBMYSQL | MYSQL | | OBORACLE | ORACLE | 其中 OBMYSQL 为 OceanBase 数据库的 MySQL租户，OBORACLE 为 OceanBase 数据库的 Oracle 租户。 - 当前支持的源端和目标端数据库详细的版本，详情如下。 | 数据库类型 | 数据库版本 | | --- | --- | | TiDB | tidb4 tidb5 | | PG | pgsql10 | | SYBASE | sybase15 | | DB2 IBM i | db2ibmi71 | | DB2 LUW | db2luw970 db2luw1010 db2luw1050 db2luw111 db2luw115 | | MYSQL | mysql56 mysql57 mysql | | ORACLE | oracle9i oracle10g oracle11g oracle12c oracle18c oracle19c | | OBMYSQL | obmysql14x obmysql21x obmysql22x obmysql200 obmysql211 obmysql2210 obmysql2230 obmysql2250 obmysql2271 ~ obmysql2277 obmysql30x obmysql31x obmysql32x obmysql322 obmysql40 | | OBORACLE | oboracle2220 oboracle2230 oboracle2250 oboracle2270 ~ oboracle2277 oboracle21x oboracle22x oboracle30x oboracle31x oboracle32x oboracle322 oboracle40 | 运行后的输出文件在用户 `home` 目录的 `output` 下。 ```shell $tree ~/output/dbcat-20xx-xx-xx-164533/ /home/qing.meiq/output/dbcat-20xx-xx-xx-164533/ ├── tpccdb │ └── TABLE-schema.sql └── tpccdb-conversion.html 1 directory, 2 files ``` ## 导入 OceanBase 数据库 使用 DBCAT 导出的文件格式为 SQL 文件，这里可以通过 ODC 的导入功能批量将表结构导入 OceanBase 数据库，更多信息请参考 [批量导出与导入](https://www.oceanbase.com/docs/enterprise-odc-doc-cn-10000000001033324)。 也可以使用 `source` 命令将 SQL 文件数据导入 OceanBase 数据库，示例如下： ```shell obclient [test]> source TABLE-schema.sql Query OK, 0 rows affected (0.044 sec) ``` #### 注意 如果 SQL 文件不在当前目录下，则需要使用绝对地址。 ## 导数结果验证 示例：查看一个表结构在 Oracle 数据库的表结构和 OceanBase 数据库里的表结构。 查看源数据库 Oracle 的表 bmsql_customer 的表结构： ```shell SQL> desc bmsql_customer; Name Null? Type ----------------------------------------- -------- ---------------------------- C_W_ID NOT NULL NUMBER(38) C_D_ID NOT NULL NUMBER(38) C_ID NOT NULL NUMBER(38) C_DISCOUNT NUMBER(4,4) C_CREDIT CHAR(2) C_LAST VARCHAR2(16) C_FIRST VARCHAR2(16) C_CREDIT_LIM NUMBER(12,2) C_BALANCE NUMBER(12,2) C_YTD_PAYMENT NUMBER(12,2) C_PAYMENT_CNT NUMBER(38) C_DELIVERY_CNT NUMBER(38) C_STREET_1 VARCHAR2(20) C_STREET_2 VARCHAR2(20) C_CITY VARCHAR2(20) C_STATE CHAR(2) C_ZIP CHAR(9) C_PHONE CHAR(16) C_SINCE TIMESTAMP(6) C_MIDDLE CHAR(2) C_DATA VARCHAR2(500) ``` 查看目标库数据库 OceanBase 的表 bmsql_customer 的表结构： ```shell obclient [SYS]> desc bmsql_customer; +----------------+---------------+------+-----+---------+-------+ | FIELD | TYPE | NULL | KEY | DEFAULT | EXTRA | +----------------+---------------+------+-----+---------+-------+ | C_W_ID | NUMBER(38) | NO | PRI | NULL | NULL | | C_D_ID | NUMBER(38) | NO | PRI | NULL | NULL | | C_ID | NUMBER(38) | NO | PRI | NULL | NULL | | C_DISCOUNT | NUMBER(4,4) | YES | NULL | NULL | NULL | | C_CREDIT | CHAR(2) | YES | NULL | NULL | NULL | | C_LAST | VARCHAR2(16) | YES | NULL | NULL | NULL | | C_FIRST | VARCHAR2(16) | YES | NULL | NULL | NULL | | C_CREDIT_LIM | NUMBER(12,2) | YES | NULL | NULL | NULL | | C_BALANCE | NUMBER(12,2) | YES | NULL | NULL | NULL | | C_YTD_PAYMENT | NUMBER(12,2) | YES | NULL | NULL | NULL | | C_PAYMENT_CNT | NUMBER(38) | YES | NULL | NULL | NULL | | C_DELIVERY_CNT | NUMBER(38) | YES | NULL | NULL | NULL | | C_STREET_1 | VARCHAR2(20) | YES | NULL | NULL | NULL | | C_STREET_2 | VARCHAR2(20) | YES | NULL | NULL | NULL | | C_CITY | VARCHAR2(20) | YES | NULL | NULL | NULL | | C_STATE | CHAR(2) | YES | NULL | NULL | NULL | | C_ZIP | CHAR(9) | YES | NULL | NULL | NULL | | C_PHONE | CHAR(16) | YES | NULL | NULL | NULL | | C_SINCE | TIMESTAMP(6) | YES | NULL | sysdate | NULL | | C_MIDDLE | CHAR(2) | YES | NULL | NULL | NULL | | C_DATA | VARCHAR2(500) | YES | NULL | NULL | NULL | +----------------+---------------+------+-----+---------+-------+ 21 rows in set (0.002 sec) ``` 经对比是一致的。 上一篇 下一篇 ![有帮助](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) 咨询热线