配置数据迁移
环境要求
系统环境
- 操作系统:Windows / Linux
- Java 版本:JRE 1.8+
- Python 版本:Python 3.x
- 数据库状态:源数据库和目标数据库已安装并正常运行
- 用户权限:用户拥有源数据库和目标数据库的相关操作权限,包括:
- 数据库的创建权限
- 表数据的读取权限
- 表数据的写入权限
安装包
KDTS 提供跨平台支持,针对不同操作系统提供相应的安装包格式:
- Windows:KaiwuDB_Data_Transformer-x.x.x-win-x86_64.zip
- Linux:KaiwuDB_Data_Transformer-x.x.x-linux-x86_64.tar.gz
配置数据迁移
启动工具
Windows 环境
- 解压缩 KaiwuDB 数据迁移工具安装包,进入安装包目录。
- 双击运行
KaiwuDB Data Transformer.exe
。
Linux 环境
- 解压缩 KaiwuDB 数据迁移工具安装包,进入安装包目录。
- 双击运行
KaiwuDB Data Transformer
或通过命令行执行。
创建工程
在左侧的数据迁移导航窗口中,右键点击空白区域,选择 创建 > 工程。
在新建工程窗口中,输入工程名称,根据需要设置工程描述,然后点击确定。系统将自动创建对应的工程目录。
创建迁移任务
展开新建的工程目录,右键点击下方的迁移目录,依次选择 创建 > 迁移。
在新建迁移任务窗口,输入迁移任务名称,根据需要填写迁移描述,然后点击确定。系统将自动跳转至新建迁移任务的主页。
配置数据迁移
在迁移任务配置窗口,点击下一步。
在迁移方式页面,设置迁移方式和数据源:
迁移方式:支持选择仅结构、仅数据、以及结构+数据三种迁移方式
数据源:目标端选择 KaiwuDB 时,需选择要迁移的引擎类型(关系引擎/时序引擎),默认为时序引擎
说明
目前只支持以下结构或结构+数据迁移:
- MySQL、Oracle 或 PostgreSQL 迁移到 KaiwuDB 关系和时序引擎
- TDengine 或 InfluxDB 迁移到 KaiwuDB 时序引擎
在源端信息页,选择主机或 URL 连接模式,配置相应的连接参数信息。系统会自动校验连接信息,校验成功后方可进行下一步。
在目标信息页,选择主机或 URL 连接模式,配置相应的连接参数信息。系统会自动校验连接信息,校验成功后方可进行下一步。
在迁移选项页,根据需要设置结构迁移和数据迁移的参数信息。
参数说明
自动执行
:控制是否自动执行 DDL 建表语句- 选择自动执行:自动在 KaiwuDB 数据库中创建表结构
- 取消自动执行:用户可手动执行建表脚本(脚本位于 kdts/data/sql_scripts 目录)
迁移约束
:目前暂不支持迁移默认约束迁移索引
:控制生成的 DDL 语句中是否包含索引创建语句迁移视图
:目前仅支持 MySQL 视图迁移通道速度
:单位为字节,默认值 1048576 表示 1 MiB
在选择对象页,选择整库迁移或多表迁移:
整库迁移
说明
- 目标数据库的库名必须与源数据库的库名相同。如果登录 KaiwuDB 数据库的用户为
admin
角色的成员,则无需提前建库,KaiwuDB 将自动创建与源数据库同名的数据库。 - 整库迁移仅支持 MySQL、Oracle、PostgreSQL 到 KaiwuDB 关系引擎的迁移。
在源端填写待迁移的数据库名或路径信息。
在目标端填写目标数据库名,然后点击下一步。
- 目标数据库的库名必须与源数据库的库名相同。如果登录 KaiwuDB 数据库的用户为
多表迁移
在源端填写待迁移的数据库名或路径信息。
在目标端填写目标数据库名。
点击添加按钮,添加迁移的数据表名,根据需要选择迁移所有列或指定列。
在源端对象和目标端对象中,填写源表名和目标表名。
(可选)点击映射关系下的设置,选择待迁移的字段,未指定时,表示迁移所有表字段。
点击下一步。
在检查确认页面,检查参数配置信息。配置无误后,点击确定按钮开始执行迁移。
(可选)在任务进度页查看迁移进度,等待迁移完成。