SQL迁移工具

SQL迁移工具帮助用户将SQL语法转换为ANSI 2003 的SQL语法。目前仅支持Hive 和 Impala SQL语法。

使用SQL迁移工具

下载hetu-sql-migration-cli-{version number}-executable.jar， 并重命名为 openlk-sql-migration-cli， 可以运行该命令chmod +x让它变成可执行的， 然后运行它。

交互模式

该工具支持交互模式运行。例如：

./openlk-sql-migration-cli --type hive

lk:HIVE>
lk:HIVE> INSERT INTO TABLE table1 VALUES(10, "NAME");
==========converted result==========
INSERT INTO table1
 VALUES
  ROW (10, 'NAME')
=================Success=============

下面是一些常用的命令：

批处理模式

该工具还可以获取参数并以批处理模式运行。该模式有五个参数，分别是“file”、“sourceType”、“execute”、“output”和“config”。 各参数的含义如下：

提示：

如果用户有大量的SQL语句需要转换，建议是将所有语句合并到一个文件中，并使用批处理模式

批处理模式使用示例：

    ./openlk-sql-migration-cli --file /home/Query01.sql --output ./
    May 26, 2020 5:27:10 PM io.airlift.log.Logger info
    INFO: Migration Completed.
    May 26, 2020 5:27:10 PM io.airlift.log.Logger info
    INFO: Result is saved to .//Query01_1590485230193.html

当指定file时，必须提供参数output。转换后的结果会保存在output目录下的html文件中，用户可以使用任意浏览器打开该html文件查看详细转化结果。

执行模式

可以使用命令直接执行查询，并在转换完成后退出工具。使用execute的示例：

./openlk-sql-migration-cli --execute "INSERT INTO TABLE T1 VALUES(10, 'openLooKeng')" --type hive
==========converted result==========
INSERT INTO t1
 VALUES
  ROW (10, 'openLooKeng')
=================Success=============

如果用户只指定了参数execute，则转换后的结果会打印到屏幕上。用户可自行指定output参数，将结果保存到目标文件中。

用户还可以提供config参数来控制转换行为。config示例：

文件名为“config.properties”，内容如下：

convertDecimalLiteralsAsDouble=true
./openlk-sql-migration-cli --execute "INSERT INTO TABLE T1 select 2.0 * 3" --config config.properties
==========converted result==========
INSERT INTO t1
SELECT (DECIMAL '2.0' * 3)
=================Success=============

配置文件目前只支持一个属性convertDecimalLiteralsAsDouble。该属性意思是是否将十进制文本转换为double默认值为false，意味着将十进制文字转换为“decimal”类型。

Hive语句检查列表：

以下Hive语句完全支持：

以下Hive语句部分支持，即不支持某些关键字或属性：

由于特性差异，如下Hive语句暂不支持：

Impala 语句检查列表：

以下Impala语句完全支持：

以下Impala语句部分支持，即不支持某些关键字或属性：

由于特性差异，如下Impala语句暂不支持：

限制

不支持对SQL语句中的UDF和函数进行转换。