gaussdb 数据库连接工具【gsql 元命令参考】【04】

表6 可调节的打印选项

选项	选项说明	取值范围
border	value必须是一个数字。通常这个数字越大，表的边界就越宽线就越多，但是这个取决于特定的格式。	在HTML格式下，取值范围为大于0的整数。 在其他格式下，取值范围： 0：无边框 1：内部分隔线 2：台架
expanded (或 x)	在正常和扩展格式之间切换。	当打开扩展格式时，查询结果用两列显示，字段名称在左、数据在右。这个模式在数据无法放进通常的"水平"模式的屏幕时很有用。 在正常格式下，当查询输出的格式比屏幕宽时，用扩展格式。正常格式只对aligned和wrapped格式有用。
fieldsep	声明域分隔符来实现非对齐输出。这样就可以创建其他程序希望的制表符或逗号分隔的输出。要设置制表符域分隔符，键入\pset fieldsep '\t'。缺省域分隔符是 '|' (竖条符)。	-
fieldsep_zero	声明域分隔符来实现非对齐输出到零字节。	-
footer	用来切换脚注。	-
format	设置输出格式。允许使用唯一缩写（这意味着一个字母就够了）。	取值范围： unaligned aligned wrapped html latex troff-ms
null	打印一个字符串，用来代替一个null值。	缺省是什么都不打印，这样很容易和空字符串混淆。
numericlocale	切换分隔小数点左边的数值的区域相关的分组符号。	on：显示指定的分隔符。 off：不显示分隔符。 忽略此参数，显示默认的分隔符。
pager	控制查询和gsql帮助输出的分页器。如果设置了环境变量PAGER，输出将被指向到指定程序，否则使用系统缺省。	on：当输出到终端且不适合屏幕显示时，使用分页器。 off：不使用分页器。 always：当输出到终端无论是否符合屏幕显示时，都使用分页器。
recordsep	声明在非对齐输出格式时的记录分隔符。	-
recordsep_zero	声明在非对齐输出到零字节时的记录分隔符。	-
tableattr（或T）	声明放在html输出格式中HTML table标签的属性（例如：cellpadding或bgcolor）。注意：这里可能不需要声明border，因为已经在\pset border里用过了。如果没有给出value，则不设置表的属性。	-
title	为随后打印的表设置标题。这个可以用于给输出一个描述性标签。如果没有给出value，不设置标题。	-
tuples_only (或者t)	在完全显示和只显示实际的表数据之间切换。完全显示将输出像列头、标题、各种脚注等信息。在tuples_only模式下，只显示实际的表数据。	-

表7 连接元命令

参数	参数说明	取值范围
\c[onnect] [DBNAME|- USER|- HOST|- PORT|-]	连接到一个新的数据库（当前数据库为postgres）。	-
\encoding [ENCODING]	设置客户端字符编码格式。	不带参数时，显示当前的编码格式。
\conninfo	输出当前连接的数据库的信息。	-

表8 操作系统元命令

参数	参数说明	取值范围
\cd [DIR]	切换当前的工作目录。	绝对路径或相对路径，且满足操作系统路径命名规则。
\setenv NAME [VALUE]	设置环境变量NAME为VALUE，如果没有给出VALUE值，则不设置环境变量。	-
\timing [on|off]	以毫秒为单位显示每条SQL语句的执行时间。	on表示打开显示。 off表示关闭显示。
\! [COMMAND]	返回到一个单独的Unix shell或者执行Unix命令COMMAND。	-

表9 变量元命令

参数	参数说明	取值范围
\prompt [TEXT] NAME	提示用户用文本格式来指定变量名字。	-
\set [NAME [VALUE]]	设置内部变量NAME为VALUE或者如果给出了多于一个值，设置为所有这些值的连接结果。如果没有给出第二个参数，只设变量不设值。	-
\unset NAME	不设置（或删除）gsql变量名。	-

表10 大对象元命令

参数	参数说明	取值范围
\lo_export LOBOID FILE	从数据库里读取OID为LOBOID的大对象并把它写到 FILE里。	-
\lo_import FILE [COMMENT]	把文件存储为GaussDB大对象。可以带有该对象的注释。	-
\lo_list	显示一个目前存储在该数据库里的所有GaussDB大对象和提供给他们的注释。	-
\lo_unlink LOBOID	从数据库里删除OID为LOBOID的大对象。	-