zsql提供了的命令行接口，帮助用户连接服务端、使用GaussDB 100。zsql具有自己独特的命令和环境。

zsql执行主要有三种用法：

用法一：zsql -h | -v
用法二：zsql
不带任何参数执行zsql，进入交互模式，再通过'conn user/password@host:port'连接到数据库。
用法三：zsql [ <logon> [<options>] [<start>] ]
登入方式<logon>包括[user [ /password ] @host:port] [ / as { sysdba | clsmgr } [ host:port ] ]
登入选项<options>包括[-q] [-w <timeout>] [-a]
开始选项<start>包括[-c "execute-sql-command"] [-f "execute-sql-file"] [-s "destination-file"]
-c 执行SQL语句和 -f 执行文件结束后，zsql进程主动结束退出；其它方式，需要用户手动输入quit或者exit退出结束zsql进程。

zsql命令行在unix环境下按一次退格键为删除输入缓冲区中的一个字节。

环境上为UTF-8编码时删除一个中文需要连按三次退格键，若想要一次删除一个字符或支持命令行上下翻、左右移功能，可以在unix上安装rlwrap。

参数说明

表1 zsql执行参数说明
参数	功能
-h	查看使用帮助。
-v	查看版本信息。
-c	执行单条SQL语句。该参数不能和-f或-s参数同时使用，且使用该参数时需放置在命令末尾。
-f	执行SQL脚本。该参数不能和-c或-s参数同时使用，且使用该参数时需放置在命令末尾。
-s	对命令提示和回显输出重定向到指定文件。该参数不能和-c或-f参数同时使用，且使用该参数时需放置在命令末尾
-w	客户端连接数据库时设置等待超时时间。
-q	取消SSL登录认证检查。
-a	打印执行的SQL语句。该参数可以和-f同时使用，即表示打印并执行SQL脚本中的SQL语句
-D	指定数据库客户端登录使用的数据目录
user	登入用户名
password	登入用户密码
host	登入数据库服务IP地址，当前支持IPV4和IPV6
port	登入数据库服务端口号
<timeout>	超时时间设置数值，单位秒，当前默认为10s。特殊数字：-1表示超时时间无穷大，0表示不等待
sysdba	登录方式关键字，免密登录后拥有最高权限
clsmgr	登录方式关键字，免密登录后拥有最高权限
"execute-sql-command"	执行的SQL语句，多行通过';'隔开, SQL语句必须用单引号或者双引号包含
"execute-sql-file"	执行的SQL文件名, 只支持单个文件，SQL文件名必须用单引号或者双引号包含，可以为zsql执行文件所在的相对路径或者绝对路径
"destination-file	重定向文件名，只支持单个文件，文件名必须用单引号或者双引号包含，可以为zsql执行文件所在的相对路径或者绝对路径
“data_home_path”	数据库客户端登录的数据目录，目录名必须用单引号或者双引号包含，可以为zsql执行文件所在的相对路径或者绝对路径

示例：
--通过sys用户免密登录数据库
zsql / as sysdba
--通过lisi用户和IP地址127.0..1和端口1611登录数据库
zsql lisi/xxx@127...1:1611
--通过xiaoming用户和IP地址127.0..1和端口1611登录数据库并执行SQL 'SELECT 1 FROM DUAL'
zsql xiaoming/xxx@127...1:1611 -c "SELECT 1 FROM DUAL"
--通过zhangsan用户和IP地址127.0..1和端口1611登录数据库并执行文件'/home/zhangsan/example.sql'
zsql zhangsan/xxx@127...1:1611 -f "/home/zhangsan/example.sql"

表2 zsql交互命令说明
命令	功能
CONN，CONNECT	连接数据库, 或者切换用户登录。 / AS SYSDBA -D db_home_path SYS用户允许本地免密登录，集群环境下必须指定DN数据文件路径。 / AS clsmgr 集群系统管理员，仅支持在集群管理节点连接。
DESCRIBE，DESC	查看数据库对象。
PROMPT	打印用户信息。
SPOOL	记录操作日志。
SET	设置参数。
SHOW	查询参数。
DUMP	单机/主备部署模式下，参考“《开发者指南（单机）》 > 语法参考 > 功能语法 > DUMP”。分布式部署模式下，参考“《开发者指南（分布式）》 > 语法参考 > 功能语法 > DUMP”。
LOAD	单机/主备部署模式下，参考“《开发者指南（单机）》 > 语法参考 > 功能语法 > LOAD”。分布式部署模式下，参考“《开发者指南（分布式）》 > 语法参考 > 功能语法 > LOAD”。
EXP	单机/主备部署模式下，参考“《开发者指南（单机）》 > 语法参考 > 功能语法 > EXP”。分布式部署模式下，参考“《开发者指南（单机）》 > 语法参考 > 功能语法 > EXP”。
IMP	单机/主备部署模式下，参考“《开发者指南（单机）》 > 语法参考 > 功能语法 > IMP”。分布式部署模式下，参考“《开发者指南（单机）》 > 语法参考 > 功能语法 > IMP”。
WSR	生成分析报告。
EXIT，QUIT	退出zsql工具。
START	执行文件
@	执行文件
@@	执行文件

ITPub博客

zsql-概述

参数说明

最新文章