文档下载建议反馈入口

  • 环境要求
  • 配置数据迁移

配置数据迁移

环境要求

系统环境

  • 操作系统: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 环境

    1. 解压缩 KaiwuDB 数据迁移工具安装包,进入安装包目录。
    2. 双击运行 KaiwuDB Data Transformer.exe
  • Linux 环境

    1. 解压缩 KaiwuDB 数据迁移工具安装包,进入安装包目录。
    2. 双击运行 KaiwuDB Data Transformer 或通过命令行执行。

创建工程

  1. 在左侧的数据迁移导航窗口中,右键点击空白区域,选择 创建 > 工程

  2. 在新建工程窗口中,输入工程名称,根据需要设置工程描述,然后点击确定。系统将自动创建对应的工程目录。

创建迁移任务

  1. 展开新建的工程目录,右键点击下方的迁移目录,依次选择 创建 > 迁移

  2. 在新建迁移任务窗口,输入迁移任务名称,根据需要填写迁移描述,然后点击确定。系统将自动跳转至新建迁移任务的主页。

配置数据迁移

  1. 在迁移任务配置窗口,点击下一步

  2. 在迁移方式页面,设置迁移方式和数据源:

    • 迁移方式:支持选择仅结构、仅数据、以及结构+数据三种迁移方式

    • 数据源:目标端选择 KaiwuDB 时,需选择要迁移的引擎类型(关系引擎/时序引擎),默认为时序引擎

      说明

      目前只支持以下结构或结构+数据迁移:

      • MySQL、Oracle 或 PostgreSQL 迁移到 KaiwuDB 关系和时序引擎
      • TDengine 或 InfluxDB 迁移到 KaiwuDB 时序引擎
  3. 在源端信息页,选择主机或 URL 连接模式,配置相应的连接参数信息。系统会自动校验连接信息,校验成功后方可进行下一步。

  4. 在目标信息页,选择主机或 URL 连接模式,配置相应的连接参数信息。系统会自动校验连接信息,校验成功后方可进行下一步。

  5. 在迁移选项页,根据需要设置结构迁移和数据迁移的参数信息。

    参数说明

    • 自动执行:控制是否自动执行 DDL 建表语句
      • 选择自动执行:自动在 KaiwuDB 数据库中创建表结构
      • 取消自动执行:用户可手动执行建表脚本(脚本位于 kdts/data/sql_scripts 目录)
    • 迁移约束:目前暂不支持迁移默认约束
    • 迁移索引:控制生成的 DDL 语句中是否包含索引创建语句
    • 迁移视图:目前仅支持 MySQL 视图迁移
    • 通道速度:单位为字节,默认值 1048576 表示 1 MiB
  6. 在选择对象页,选择整库迁移或多表迁移:

    • 整库迁移

      说明

      • 目标数据库的库名必须与源数据库的库名相同。如果登录 KaiwuDB 数据库的用户为 admin 角色的成员,则无需提前建库,KaiwuDB 将自动创建与源数据库同名的数据库。
      • 整库迁移仅支持 MySQL、Oracle、PostgreSQL 到 KaiwuDB 关系引擎的迁移。
      1. 在源端填写待迁移的数据库名或路径信息。

      2. 在目标端填写目标数据库名,然后点击下一步

    • 多表迁移

      1. 在源端填写待迁移的数据库名或路径信息。

      2. 在目标端填写目标数据库名。

      3. 点击添加按钮,添加迁移的数据表名,根据需要选择迁移所有列或指定列。

      4. 在源端对象和目标端对象中,填写源表名和目标表名。

      5. (可选)点击映射关系下的设置,选择待迁移的字段,未指定时,表示迁移所有表字段。

      6. 点击下一步

  7. 在检查确认页面,检查参数配置信息。配置无误后,点击确定按钮开始执行迁移。

  8. (可选)在任务进度页查看迁移进度,等待迁移完成。