命令行工具

1. 概述

UDB-DS 为用户提供 cli/Shell 工具用于启动客户端和服务端程序，可在 sbin 文件夹下找到。下面介绍每个 cli/Shell 工具的运行方式和相关参数。

$UDB-DS_HOME 表示 UDB-DS 的安装目录所在路径。

2. 运行

2.1 Cli 运行方式

安装后的 UDB-DS 中有一个默认用户：root，默认密码为root。用户可以使用该用户尝试运行 UDB-DS 客户端以测试服务器是否正常启动。客户端启动脚本为$UDB-DS_HOME/sbin 文件夹下的start-cli脚本。启动脚本时需要指定运行 IP 和 RPC PORT。以下为服务器在本机启动，且用户未更改运行端口号的示例，默认端口为 7777。若用户尝试连接远程服务器或更改了服务器运行的端口号，请在-h 和-p 项处使用服务器的 IP 和 RPC PORT。
用户也可以在启动脚本的最前方设置自己的环境变量，如 JAVA_HOME 等。

启动命令如下：

Shell > bash sbin/start-cli.sh -h 127.0.0.1 -p 7777 -u root -pw root

回车后即可成功启动客户端。启动后出现如图提示即为启动成功。

---------------------
Starting UDB-DS Cli
---------------------
 _   _ ____  ____        ____  ____
| | | |  _ \| __ )      |  _ \/ ___|
| | | | | | |  _ \ _____| | | \___ \
| |_| | |_| | |_) |_____| |_| |___) |
 \___/|____/|____/      |____/|____/  version 2.0.1 (Build: 24706b6)
                                           

Successfully login at 127.0.0.1:7777

输入quit或exit可退出 cli 结束本次会话，cli 输出quit normally表示退出成功。

2.2 Cli 运行参数

参数名	参数类型	是否为必需参数	说明	例子
-disableISO8601	没有参数	否	如果设置了这个参数，UDB-DS 将以数字的形式打印时间戳 (timestamp)。	-disableISO8601
-h <`host`>	string 类型，不需要引号	是	UDB-DS 客户端连接 UDB-DS 服务器的 IP 地址。	-h 10.129.187.21
-help	没有参数	否	打印 UDB-DS 的帮助信息	-help
-p <`rpcPort`>	int 类型	是	UDB-DS 连接服务器的端口号，UDB-DS 默认运行在 7777 端口。	-p 7777
-pw <`password`>	string 类型，不需要引号	否	UDB-DS 连接服务器所使用的密码。如果没有输入密码 UDB-DS 会在 Cli 端提示输入密码。	-pw root
-u <`username`>	string 类型，不需要引号	是	UDB-DS 连接服务器锁使用的用户名。	-u root
-maxPRC <`maxPrintRowCount`>	int 类型	否	设置 UDB-DS 返回客户端命令行中所显示的最大行数。	-maxPRC 10
-e <`execute`>	string 类型	否	在不进入客户端输入模式的情况下，批量操作 UDB-DS	-e "show databases"
-c	空	否	如果服务器设置了 `rpc_thrift_compression_enable=true`, 则 CLI 必须使用 `-c`	-c

下面展示一条客户端命令，功能是连接 IP 为 10.129.187.21 的主机，端口为 7777 ，用户名为 root，密码为 root，以数字的形式打印时间戳，UDB-DS 命令行显示的最大行数为 10。

系统启动命令如下：

Shell > bash sbin/start-cli.sh -h 10.129.187.21 -p 7777 -u root -pw root -disableISO8601 -maxPRC 10

2.3 CLI 特殊命令

下面列举了一些CLI的特殊命令。

命令	描述 / 例子
`set time_display_type=xxx`	例如： long, default, ISO8601, yyyy-MM-dd HH:mm:ss
`show time_display_type`	显示时间显示方式
`set time_zone=xxx`	例如： +08:00, Asia/Shanghai
`show time_zone`	显示CLI的时区
`set fetch_size=xxx`	设置从服务器查询数据时的读取条数
`show fetch_size`	显示读取条数的大小
`set max_display_num=xxx`	设置 CLI 一次展示的最大数据条数，设置为-1表示无限制
`help`	获取CLI特殊命令的提示
`exit/quit`	退出CLI

2.4 Cli 的批量操作

当您想要通过脚本的方式通过 Cli / Shell 对 UDB-DS 进行批量操作时，可以使用-e 参数。通过使用该参数，您可以在不进入客户端输入模式的情况下操作 UDB-DS。

为了避免 SQL 语句和其他参数混淆，现在只支持-e 参数作为最后的参数使用。

针对 cli/Shell 工具的-e 参数用法如下：

Shell > bash sbin/start-cli.sh -h {host} -p {rpcPort} -u {user} -pw {password} -e {sql for udbds}

为了更好的解释-e 参数的使用，可以参考下面的例子。

假设用户希望对一个新启动的 UDB-DS 进行如下操作：

创建名为 root.demo 的 database
创建名为 root.demo.s1 的时间序列
向创建的时间序列中插入三个数据点
查询验证数据是否插入成功

那么通过使用 cli/Shell 工具的 -e 参数，可以采用如下的脚本：

# !/bin/bash

host=127.0.0.1
rpcPort=7777
user=root
pass=root

bash ./sbin/start-cli.sh -h ${host} -p ${rpcPort} -u ${user} -pw ${pass} -e "CREATE DATABASE root.demo"
bash ./sbin/start-cli.sh -h ${host} -p ${rpcPort} -u ${user} -pw ${pass} -e "create timeseries root.demo.s1 WITH DATATYPE=INT32, ENCODING=RLE"
bash ./sbin/start-cli.sh -h ${host} -p ${rpcPort} -u ${user} -pw ${pass} -e "insert into root.demo(timestamp,s1) values(1,10)"
bash ./sbin/start-cli.sh -h ${host} -p ${rpcPort} -u ${user} -pw ${pass} -e "insert into root.demo(timestamp,s1) values(2,11)"
bash ./sbin/start-cli.sh -h ${host} -p ${rpcPort} -u ${user} -pw ${pass} -e "insert into root.demo(timestamp,s1) values(3,12)"
bash ./sbin/start-cli.sh -h ${host} -p ${rpcPort} -u ${user} -pw ${pass} -e "select s1 from root.demo"

打印出来的结果显示如下，通过这种方式进行的操作与客户端的输入模式以及通过 JDBC 进行操作结果是一致的。

 Shell > bash ./shell.sh 
+-----------------------------+------------+
|                         Time|root.demo.s1|
+-----------------------------+------------+
|1970-01-01T08:00:00.001+08:00|          10|
|1970-01-01T08:00:00.002+08:00|          11|
|1970-01-01T08:00:00.003+08:00|          12|
+-----------------------------+------------+
Total line number = 3
It costs 0.267s

需要特别注意的是，在脚本中使用 -e 参数时要对特殊字符进行转义。