2. 快速开始

本章包含下载、配置、运行 三个步骤,用户可遵循本章的步骤快速开始使用 LightDB-ETL

另外,本章节总结了基本的使用,特殊的一些需求如如果只迁移单个表、如果迁移单个schema、如何在迁移时排除指定的表可参考第三章。

2.1. 环境准备

2.1.1. Java 1.8

需要 Java 1.8 及以上版本, 下载地址

2.1.2. 内存

具体所需内存根据迁移开启的线程数量(concurrentThreadCount)、每次迁移数据的行数(batchCount)、表每行的数据大小(由列的数量、数据类型等确定)。 以下是一个实际的内存占用情况,可供计算迁移所需内存大小:

前提:每个表500M,每次读取20万行数据,每行数据0.1kb。

线程数

内存

1

600M

2

1.2g

2.1.3. LightDB-ETL

下载迁移工具 LightDB-ETL

2.2. 修改配置

修改 config 目录下的application.properties 配置文件,配置源端数据库、目标端数据库、迁移选项、日志选项。详细配置参数的含义参考第四章配置参数的说明。

2.2.1. 修改迁移的数据库类型

etl.global.sourceDatabase=oracle
etl.global.targetDatabase=lightdb

2.2.2. 修改源库Oracle连接

etl.source.jdbc.url=数据库连接地址
etl.source.jdbc.username=数据库用户名
etl.source.jdbc.password=数据库密码

2.2.3. 修改目标库LightDB连接

etl.target.jdbc.url=数据库连接地址
etl.target.jdbc.username=数据库用户名
etl.target.jdbc.password=数据库密码

2.2.4. 修改 keywords 配置

该选项是如果列名有关键字如by,需要配置etl.global.keywords。没有则可忽略此项

etl.global.keywords=by,commit

2.2.5. 修改迁移功能和迁移的模式

详细参数说明参考第四章配置选项说明参数。特别注意,如果数据库存在依赖关系,需要分多次步骤迁移,如存储过程依赖函数,则需要先迁移函数,在迁移存储过程。

etl.global.transferSchemas=schema1
etl.global.targetSchemas=schema2
etl.global.enableFunctions=TransferTable,TransferSequence,TransferTableData,TransferIndex,TransferView,TransferTrigger,TransferPackage,TransferType,TransferProcedure,TransferFunction,TableCompare,TableDataCompare,TypeCountCompare

2.3. 运行

执行 java -jar <jar包名> 命令运行迁移程序。如jar包名是lightdb-etl.jar,则执行java -jar lightdb-etl.jar

2.4. 校验查看

在logs/lightdb-etl/lightdb-etl.log文件里面搜索不一致。如果有不一致信息,表明迁移出错。详细例子,可看第五章。迁移出错问题分析可查看 lightdb-etl oracle迁移到lightdb的常见问题和解决方法