使用 DBCAT 迁移 DB2 LUW 表结构到 OceanBase 数据库

更新时间：2026-06-07 16:06:21

编辑

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 示例：

$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

解压安装文件：

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 文件与报告文件，运行时生成。

导出 DB2 LUW 数据库的表结构

DBCAT 具有在线转换功能，该功能是指 DBCAT 能直连源端数据库，将数据库中的对象导出。当对象非常多时（如超过 1 万），导出过程可能会有点慢。

dbcat 导出命令如下：

bin/dbcat convert -H<host> -P<port> -u<user> -p<******>  -D<database> --schema <schema> --from <from> --to <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	N	导出的函数
--procedure	N	导出的存储过程
--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 类型

这里以导出 DB2 LUW 11.5.x 版本下 database 为 test 的所有对象的结构，并将其迁移到 4.0.0 版本的 OceanBase 集群中的 MySQL 租户为示例。

bin/dbcat convert -H xxx.xxx.xxx.xxx -P 50001 -udb2inst2 -p****** --schema TESTDB -DTESTDB --table bmsql_customer --from db2luw115 --to obmysql32x --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</80>
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 下。

$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 数据库，更多信息请参考批量导出与导入。

也可以使用 source 命令将 SQL 文件数据导入 OceanBase 数据库，示例如下：

obclient [test]> source TABLE-schema.sql
Query OK, 0 rows affected (0.044 sec)

注意

如果 sql 文件不在当前目录下，则需要使用绝对地址。

导数结果验证

示例：查看一个表结构在 DB2 LUW 里的书写方式和 OceanBase 数据库里的表结构。

查看源数据库 DB2 LUW 的表 bmsql_customer 的建表 SQL：

db2 => describe table  bmsql_customer

                                Data type                     Column
Column name                     schema    Data type name      Length     Scale Nulls
------------------------------- --------- ------------------- ---------- ----- ------
C_W_ID                          SYSIBM    BIGINT                       8     0 No
C_D_ID                          SYSIBM    BIGINT                       8     0 No
C_ID                            SYSIBM    BIGINT                       8     0 No
C_DISCOUNT                      SYSIBM    DECIMAL                      4     4 Yes
C_CREDIT                        SYSIBM    CHARACTER                    2     0 Yes
C_LAST                          SYSIBM    VARCHAR                     16     0 Yes
C_FIRST                         SYSIBM    VARCHAR                     16     0 Yes
C_CREDIT_LIM                    SYSIBM    DECIMAL                     12     2 Yes
C_BALANCE                       SYSIBM    DECIMAL                     12     2 Yes
C_YTD_PAYMENT                   SYSIBM    DECIMAL                     12     2 Yes
C_PAYMENT_CNT                   SYSIBM    INTEGER                      4     0 Yes
C_DELIVERY_CNT                  SYSIBM    INTEGER                      4     0 Yes
C_STREET_1                      SYSIBM    VARCHAR                     20     0 Yes
C_STREET_2                      SYSIBM    VARCHAR                     20     0 Yes
C_CITY                          SYSIBM    VARCHAR                     20     0 Yes
C_STATE                         SYSIBM    CHARACTER                    2     0 Yes
C_ZIP                           SYSIBM    CHARACTER                    9     0 Yes
C_PHONE                         SYSIBM    CHARACTER                   16     0 Yes
C_SINCE                         SYSIBM    TIMESTAMP                   10     6 Yes
C_MIDDLE                        SYSIBM    CHARACTER                    2     0 Yes
C_DATA                          SYSIBM    VARCHAR                    500     0 Yes

  21 record(s) selected.

查看目标库数据库 OceanBase 的表 bmsql_customer 的表结构：

obclient [test]> desc bmsql_customer;
+----------------+---------------+------+-----+---------+-------+
| Field          | Type          | Null | Key | Default | Extra |
+----------------+---------------+------+-----+---------+-------+
| c_w_id         | bigint(20)    | NO   | PRI | NULL    |       |
| c_d_id         | bigint(20)    | NO   | PRI | NULL    |       |
| c_id           | bigint(20)    | NO   | PRI | NULL    |       |
| c_discount     | decimal(4,4)  | YES  |     | NULL    |       |
| c_credit       | char(2)       | YES  |     | NULL    |       |
| c_last         | varchar(16)   | YES  |     | NULL    |       |
| c_first        | varchar(16)   | YES  |     | NULL    |       |
| c_credit_lim   | decimal(12,2) | YES  |     | NULL    |       |
| c_balance      | decimal(12,2) | YES  |     | NULL    |       |
| c_ytd_payment  | decimal(12,2) | YES  |     | NULL    |       |
| c_payment_cnt  | int(11)       | YES  |     | NULL    |       |
| c_delivery_cnt | int(11)       | YES  |     | NULL    |       |
| c_street_1     | varchar(20)   | YES  |     | NULL    |       |
| c_street_2     | varchar(20)   | YES  |     | NULL    |       |
| c_city         | varchar(20)   | YES  |     | NULL    |       |
| c_state        | char(2)       | YES  |     | NULL    |       |
| c_zip          | char(9)       | YES  |     | NULL    |       |
| c_phone        | char(16)      | YES  |     | NULL    |       |
| c_since        | timestamp     | YES  |     | NULL    |       |
| c_middle       | char(2)       | YES  |     | NULL    |       |
| c_data         | varchar(500)  | YES  |     | NULL    |       |
+----------------+---------------+------+-----+---------+-------+
21 rows in set (0.007 sec)

经对比发现表字段的字符类型以及长度会有一定的转变，更多关于表字段转换的信息请参见创建 DB2 LUW 至 OceanBase 数据库 Oracle 租户的数据迁移项目中的数据类型映射。