kingbase金仓数据库如何启动并使用迁移工具KDTS

在 KingbaseES（金仓数据库） 中，迁移工具通常指 KDTS。用于将数据从其他数据库（如 Oracle、MySQL、SQL Server 等）迁移到金仓数据库。
当前，KDTS支持多接口访问，部署KDTS后，可通过Web方式和SHELL方式使用该工具。

迁移工具支持源端数据库部分情况

源端数据库	源端数据库版本	支持迁移的对象类型	目标端数据库	目标端数据库版本
oracle	9i、10g、11g、12c、19c	表（包含指定表、排除指定表）、视图、序列、函数、存储过程、程序包、同义词、触发器、用户自定义类型、注释	KingbaseES	V7、V8R3、V8R6、V8R6C7、V9
MySQL	5.X、8.X	表（包含指定表、排除指定表）、视图、函数、存储过程、触发器、用户自定义类型、注释	KingbaseES	V7、V8R3、V8R6、V8R6C7、V9
PostgreSQL	9、10、12、14、16	表（包含指定表、排除指定表）、视图、序列、函数、存储过程、同义词、触发器、用户自定义类型、注释	KingbaseES	V7、V8R3、V8R6、V8R6C7、V9
SQLServer	2000、2005、2008、2012、2014、2016、2017、2019	表（包含指定表、排除指定表）、视图、序列、函数、存储过程、同义词、触发器、用户自定义类型、注释	KingbaseES	V7、V8R3、V8R6、V8R6C7、V9
Gbase	8s、8g、8t、8sV8	表（包含指定表、排除指定表）、视图、序列、函数、存储过程、同义词、触发器、用户自定义类型、注释	KingbaseES	V7、V8R3、V8R6、V8R6C7、V9
DM	7、8	表（包含指定表、排除指定表）、视图、序列、函数、程序包、存储过程、同义词、触发器、用户自定义类型、注释	KingbaseES	V7、V8R3、V8R6、V8R6C7、V9
Sybase	15.7	表、主键、外键、索引、约束、视图、函数、存储过程、触发器	KingbaseES	V7、V8R3、V8R6、V8R6C7、V9

注：表格中只展示了部分源端支持情况，除了这部分源端还支持Db2、神通(OSCAR)、Sybase、GREENPLUM、HANA、INFORMIX、OPENGAUSS、OCEANBASE、KINGBASE。详细支持情况可以查看金仓官网手册

一、确认安装

确认已经安装了KDTS迁移工具（该工具是部署数据库自带的，单独装工具需要选择客户端安装）

数据库部署自带的KDTS工具在（$KINGBASE_HOME/Clienttools/guittools/KDTS）中，有web网页版也有cli命令行版。

单独装的KDTS工具（在本地单独装工具需要下载数据库的完整版安装包，安装的时候选择客户端安装即可。工具存放路径也在安装目录的Clienttools/guittools/KDTS下）

最常用的是web网页版的工具，所以下面只展示网页版的启动以及使用方法

二、启动迁移工具

windows

方法一：

进入到数据库安装目录的Clienttools/guittools/KDTS/KDTS_WEB/bin目录中，双击startup.bat 以启动迁移工具。当弹出的终端页面有倒计时显示，即可网页登录 ip:54523 来进入网页版的KDTS工具。

方法二：

进入到数据库安装目录的Clienttools/guittools/KDTS/KDTS_WEB/bin目录中，cmd进入终端页面，执行startup.bat 。当弹出的终端页面有倒计时显示，即可网页登录 ip:54523 来进入网页版的KDTS工具。

linux

使用数据库安装用户（一般默认为kingbase用户）

su - kingbase

进入到工具目录的bin目录下（$KINGBASE_HOME/Clienttools/guittools/KDTS/KDTS_WEB/bin)

执行 ./startup.sh。

启动之后可以执行ps -ef |grep kdts来查看

是否有kdts的进程来确定工具是否在启动中

三、登录迁移工具

在上一步启动迁移工具之后，我们可以网页搜索 IP:54523来进入登录页面（本地工具可以直接写localhost:54523）

登录迁移工具的账号密码共有三版：

早期版本：admin/123456&*

中期版本是：kingbase/kingbase

最新版本是：kingbase/Kb_DI@2019

输入正确的账号密码，登录之后就进入到主页面

四、迁移数据步骤

步骤一：点击数据源管理
点击新建源数据库，并配置对应信息（如数据源类型、IP信息等）

注：在配置源端信息时，源数据库版本必须确认好。另外连接用户建议选择权限足够的用户，避免迁移过程中由于权限不足造成报错。注：在配置源端信息时，源数据库版本必须确认好。另外连接用户建议选择权限足够的用户，避免迁移过程中由于权限不足造成报错。

步骤二：点击数据源管理
点击新建目标数据库，并配置对应信息（如数据源类型、IP信息等）

注：目标端配置尤其要注意数据库版本号是否对应以及连接用户是否为数据库管理员用户（默认管理员用户为system）。注：目标端配置尤其要注意数据库版本号是否对应以及连接用户是否为数据库管理员用户（默认管理员用户为system）。

步骤三：点击迁移任务管理
点击新建迁移任务-新建
迁移任务第一步：配置迁移任务名称，并选择对应的源端、目标端的配置。

迁移任务第二步：选择要迁移的对象，默认会创建于源模式同名的目标模式，如果想迁移到指定模式下可以点击下拉框或者手敲。
目标属主，如果不选择默认是system，这里根据需要配置（建议默认）。

迁移任务第三步：选择迁移对象。如果想要迁移上一步选中的所有对象可以跳过这一步。如果想要单独迁移一部分或者排除一部分来进行迁移，需要点击左边的对应模式名，然后点击包含指定对象或者排除指定对象。

迁移任务第四步：如果没有特殊要求，可以按照目前的默认配置，直接点击保存并迁移。如果有需要配置的，可以点击源端或者目标端来切换配置页面

步骤四：等待迁移任务结束，如果显示失败，则观察迁移详情确认具体报错。