zsql客户端允许使用“SET”命令设置一些客户端参数。

语法格式

SET [attr_name] [value]

参数说明

attr_name
属性名。
可设置的属性如下所示：
- AUTO[COMMIT]
  是否自动提交。
  取值范围：
  - ON，打开自动提交。
  - OFF，关闭自动提交。
  默认值：OFF
- BIND
  是否开启强制输入绑定参数。
  - ON，开启强制输入绑定参数后，根据系统提示输入绑定参数。
  - OFF，关闭强制输入绑定参数。
  默认值：OFF。
- EXITC[OMMIT]
  是否在zsql关闭或退出时，对会话中更改的数据进行提交。
  取值范围：
  - ON，打开提交。
  - OFF，关闭提交。
  默认值：ON
- CHARSET
  客户端字符集。
  取值范围：
  - GBK
  - UTF8
  默认值：UTF8
- HEA[DING]
  设置是否显示列标题。
  取值范围：
  - ON，显示列标题。
  - OFF，不显示列标题。
  默认值：ON
- TRIMS[POOL]
  是否去除每行的拖尾空格。
  取值范围：
  - ON，去除每行的拖尾空格。
  - OFF，不去除每行的拖尾空格。
  默认值：OFF
- SERVEROUT[PUT]
  是否使用DBMS_OUTPUT.PUT_LINE包输出serveroutput的信息。
  取值范围：
  - ON，输出serveroutput信息。
  - OFF，不输出serveroutput信息。
  默认值：OFF。
- LIN[ESIZE]
  设置一行可以容纳的字符数，如果一行的输出内容大于设置的一行可容纳的字符数，则截断显示。
  取值范围：[0,+∞)
  默认值：0，即不限制。
- NUM[WIDTH]
  设置NUM的宽度。
  取值范围：[6, 52]
  默认值：40
- PAGES[IZE]
  设置一页显示的行数。
  取值范围：0或[4,+∞)
  默认值：0，即不限制。
- TIM[ING]
  设置是否显示SQL语句的运行时间，时间精确到0.001s(毫秒)。
  取值范围：
  - ON，显示。
  - OFF，不显示。
  默认值：OFF
- FEED[BACK]
  当一条sql语句返回n或者大于n行记录时，会有feedback。
  取值范围：
  - ON，设置返回条数n，[1,+∞)，大于等于n值时显示返回值记录，小于n值时不显示。
  - OFF，即n=0，不显示返回值记录。
  默认值：ON
- ECHO
  使用@符号、@@符号或者start执行sql脚本时，是否回显脚本中的sql命令。
  取值范围：
  - ON，回显脚本中的sql命令。
  - OFF，不回显脚本中的sql命令。
  默认值：OFF
- VER[IFY]
  使用替换变量功能（set define）时，有回显确认信息old sql is和new sql is提示，该命令行可以关闭和打开提示。
  取值范围：
  - ON，回显确认信息。
  - OFF，关闭回显确认信息。
  默认值：ON
- TERM[OUT]
  使用@符号执行sql脚本时，是否回显执行信息。
  取值范围：
  - ON，回显执行信息。
  - OFF，不回显执行信息。
  默认值：ON
- NEWP[AGE]
  设置页与页之间的空行数。
  取值范围：0或[1,+∞)
  默认值：1
- COLSEP
  设置列与列之间的间隔符。
  取值范围：'text'|"text"|text
  默认值：' '，表示列与列之间的间隔符是空格
- LONG
  仅做语法适配。
- DEFINE
  开启或者关闭替代变量功能。替代变量标识符默认为符号&。
  - ON，开启替代变量功能。此时，如果输入字符串中包含替代变量标识符，则替代变量标识符后面的字符串会被识别为变量名，并提示输入替代变量的值，例如，输入字符串SQL&Plus时，系统会提示输入名为Plus的替代变量的值，如果输入ABC，则字符串SQL&Plus最终会被转化为SQLABC。
  - OFF，关闭替代变量功能。替代变量标识符将作为普通字符输入，例如，输入字符串SQL&Plus时，最终输入字符是SQL&Plus。
  - one_char，更改替代变量标识符（仅支持输入一个字符），此时会自动开启替代变量功能。例如，使用“SET DEFINE @”将替代变量标识符设置为符号@。
  默认值：OFF
- OPLOG
  开启或关闭ZSQL客户端记录操作日志功能。
  取值范围：
  - ON，开启ZSQL客户端记录操作日志功能。
  - OFF，关闭ZSQL客户端记录操作日志功能。
  默认值：ON
- ZSQL_SSL[_MODE|_CA|_CERT|_CRL|_CIPHER|_KEY|_KEY_PASSWD]
  ssl相关的各个属性及文件路径配置值。
  默认值：ZSQL_SSL_MODE默认为PREFERRED，其他默认为NULL
- CONNECT[_TIMEOUT]
  配置客户端连接数据库时的等待响应超时时间。修改该参数后，当前长连接的等待响应超时时间仍然是10s。修改后，后台重新起的连接，或者使用conn name/password@ip:port再次建立的连接的超时时间为修改后的超时时间，退出zsql进程，修改失效。
  取值范围：
  - -1：表示一直等待服务器响应，不超时。
  - 0：不等待超时，直接返回。
  - n：等待n秒。
  默认值：30s
- UDS_SERVER_PATH
  配置客户端通过unix domain socket方式连接服务端时的socket文件路径。
  取值范围：
  服务端已监听该路径，并且客户端对该路径有权限访问。路径长度小于108字符。
  默认值： {GSDB_DATA} /protect/ gsdb_uds_emerg.server
- UDS_CLIENT_PATH
  可选配置。用于服务端区分不同UDS客户端连接。
  取值范围：
  没有其他UDS客户端绑定的路径。
  路径长度小于108。
  默认值：非空
value
属性值。

示例

设置参数AUTO的值为OFF，关闭自动提交。

SET AUTO OFF;

将替代变量标识符设置为符号@。

--将替代变量标识符设置为符号@
SET DEFINE @
ON

--查看替代变量标识符的当前值。
SHOW DEFINE
repalce fuction is ON and replace mark is @.

设置参数CONNECT的值为20s。

--启动zsql进程。
zsql

--设置参数CONNECT的值为20s。
set CONNECT = 20

--新建连接的等待响应超时时间为20s。
CONN omm@127.0.0.1:8000
Please enter password:
***********

--退出zsql进程。退出后设置失效，之后新建连接的等待响应超时时间仍然为默认值10s。
EXIT

设置参数BIND的值为ON。
```
SET BIND ON;
```
```
EXPLAIN SELECT ? FROM DUAL;
```
输入动态参数后，explain命令根据动态参数判断动态路由目标。
- 绑定参数为分布键，输入绑定参数后，动态路由根据绑定参数判断是否整体下沉，根据动态路由选择结果来打印执行计划。
- 绑定参数非分布键，不影响打印执行计划。

ITPub博客

zsql-设置参数

语法格式

示例

最新文章