3.2.1. 安装部署

SQL超级终端 为免安装客户端工具，将zip压缩包解压后，Windows平台通过PowerShell进入解压目录，执行.sqlclient.ps1即会列出详细的命令行选项功能介绍（同理Linux平台中对应解压目录中执行./sqlclient.sh）。

注意

对于Windows PowerShell中运行SQL终端，可能出现中文显示乱码问题，可通过以下命令来将控制台输出编码设为UTF-8（覆盖默认GBK）： [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 [Console]::InputEncoding = [System.Text.Encoding]::UTF8

3.2.2. 使用介绍

用法：

.sqlclient.ps1 [目标库] [连接信息] [选项]

选项：

命令行选项

命令选项	功能含义
–target-db	连接到的目标库，用于和version一起推断jdbc驱动(大小写不敏感)。注：如果不是–help，那么–target-db必须是第一个选项
–target-db-version	连接到的目标库版本，用于推断jdbc驱动
-u 或 –url	数据库jdbc连接URL，也可使用–host –port [–db] [–param]代替，同时指定时, 本选项具有更高的优先级
–host	数据库服务器主机地址
–port	数据库服务器主机端口
–db	默认数据库
–param	连接参数
–user	数据库用户名
-p 或 –password	数据库密码
-d 或 –driver	数据库驱动类(可选：默认基于target-db自动推断)
-v 或 –verbose	显示详细信息
-f 或 –file	执行sql文件，然后退出
–dir	执行或转换目录中的所有文件（按照ascii顺序进行，支持目录递归；文件名或目录名包含”_unisql”则转换，否则不转换），然后退出
–noexec	仅执行转换，结果输出到–output目录，不存在会自动创建
–output	执行或转换目录中的所有文件（按照ascii顺序进行，支持目录递归），然后退出
–log	执行结果重定向文件或目录。对于-f，为日志文件；对于–dir，为日志目录，在目录下会包含一个batch.err，包含所有的错误，方便用户快速定位
–unisql	走统一SQL
–source-db	走统一SQL时，源库方言(大小写不敏感)
连接到的源库版本，用于推断jdbc驱动(可选)	显示详细信息
–compare-server	比对服务器地址（不配置，则不比对）
-t 或 –timing	显示执行时间
-m 或 –max-rows	行数，交互模式下的最大显示行数 (默认: 1000000)，-f/copy/spool不受行数限制影响
–exit-on-error	出错时退出
–list-unisql-dblist	查看统一sql支持的源库和目标库列表
-h 或 –help	显示此帮助信息

命令行示例：

1.使用统一SQL转换且在目标库中执行(源mysql、目标ob-oracle):

.sqlclient.ps1 –target-db OCEAN_BASE_ORACLE –target-db-version 4020100 –url jdbc:oceanbase://10.20.47.202:2883 –user sys@oracle_tenant#obdemo –password aaAA11a –source-db mysql –unisql

2.使用统一SQL转换且在目标库中执行(源oracle、目标pg):

.sqlclient.ps1 –target-db POSTGRESQL –host 10.20.198.134 –port 5432 –db postgres –user postgres –password lightdb@123 –source-db ORACLE –unisql

3.使用统一SQL仅转换不执行(源oracle、目标pg):

.sqlclient.ps1 –target-db POSTGRESQL –source-db ORACLE –unisql –noexec

4.不使用统一SQL转换，仅在目标库执行(目标pg):

.sqlclient.ps1 –target-db POSTGRESQL –host 10.20.198.134 –port 5432 –db postgres –user postgres –password lightdb@123

5.使用统一SQL转换单个sql文件(源oracle、目标gaussdb-oracle):

.sqlclient.ps1 –target-db GAUSSDB_ORACLE –unisql –source-db ORACLE –noexec -f E:业务代码test.sql –output D:Downloadsdist20160130output_gaussdb-oracle –log D:Downloadsdistlog

6.使用统一SQL转换整个文件夹(源oracle、目标gaussdb-oracle):

.sqlclient.ps1 –target-db GAUSSDB_ORACLE –unisql –source-db ORACLE –noexec –dir E:业务代码数风RCMP5.0hsrcm-pbs-taskpublicbusinessdeploysqlsoracle_unisql –output D:Downloadsdist20160130output_gaussdb-oracle –log D:Downloadsdistlog

7.使用统一SQL转换整个文件夹(源oracle、目标gaussdb-oracle)，其中混合包含了需要转换和无需转换的sql文件:

.sqlclient.ps1 –target-db GAUSSDB_ORACLE –unisql –source-db ORACLE –noexec –dir E:业务代码数风RCMP5.0hsrcm-pbs-taskpublicbusinessdeploysqlsoracle_unisql –output D:Downloadsdist20160130output_gaussdb-oracle –log D:Downloadsdistlog

注意

1.在SQL终端交互命令中，可通过!help命令来查看完整的命令支持清单

2.–log指定输出的日志文件目录中，batch.err文件包含所有转换不支持、执行错误等导致的报错信息