设置参数
zsql客户端允许使用“SET”命令设置一些客户端参数。
语法格式
SET [attr_name] [value]参数说明
- attr_name
属性名。
可设置的属性如下所示：
- AUTO[COMMIT]
是否自动提交。
取值范围：
- ON，打开自动提交。
- OFF，关闭自动提交。
默认值：OFF
- EXITC[OMMIT]
是否在zsql关闭或退出时，对会话中更改的数据进行提交。
取值范围：
- ON，打开提交。
- OFF，关闭提交。
默认值：ON
- CHARSET
客户端字符集。
取值范围：
- GBK
- UTF8
默认值：UTF8
- HEA[DING]
设置是否显示列标题。
取值范围：
- ON，显示列标题。
- OFF，不显示列标题。
默认值：ON
- TRIMS[POOOL]
是否去除每行的拖尾空格。
取值范围：
- 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
使用@符号执行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相关的各个属性及文件路径配置值。
默认值：NULL
- CONNECT[_TIMEOUT]
配置客户端连接数据库时的等待响应超时时间。修改该参数后，当前长连接的等待响应超时时间仍然是10s。修改后，后台重新起的连接，或者使用conn name/password@ip:port再次建立的连接的超时时间为修改后的超时时间，退出zsql进程，修改失效。
取值范围：
- -1： 表示一直等待服务器响应，不超时。
- 0：不等待超时，直接返回。
- n：等待n秒。
默认值：10s
- UDS_SERVER_PATH
配置客户端通过unix domain socket方式连接服务端时的socket文件路径。
取值范围：
服务端已监听该路径，并且客户端对该路径有权限访问。路径长度小于108字符。
默认值： {GSDB_DATA} /protect/ gsdb_uds_emerg.server
- UDS_CLIENT_PATH
可选配置。用于服务端区分不同UDS客户端连接。
取值范围：
没有其他UDS客户端绑定的路径。
路径长度小于108。
默认值：空
- value
属性值。
示例
- 设置参数INTERACTIVE_TIMEOUT的值为4200。
ALTER SYSTEM SET INTERACTIVE_TIMEOUT = 4200;- 设置参数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「喜欢这篇文章，您的关注和赞赏是给作者最好的鼓励」关注作者【版权声明】本文为墨天轮用户原创内容，转载时必须标注文章的来源（墨天轮），文章链接，文章作者等基本信息，否则作者和墨天轮有权追究责任。如果您发现墨天轮中有涉嫌抄袭或者侵权的内容，欢迎发送邮件至：contact@modb.pro进行举报，并提供相关证据，一经查实，墨天轮将立刻删除相关内容。评论
