openGauss 客户端工具：gsql（4）

openGauss小助手

于 2024-09-30 10:41:40 发布

阅读量960

点赞数 7

文章标签：数据库 openGauss

本文链接：https://blog.csdn.net/weixin_53596073/article/details/142651692

版权

环境变量

表 5 与gsql相关的环境变量

名称	描述
COLUMNS	如果\set columns为0，则由此参数控制wrapped格式的宽度。这个宽度用于决定在自动扩展的模式下，是否要把宽输出模式变成竖线的格式。
PAGER	如果查询结果无法在一页显示，它们就会被重定向到这个命令。可以用\pset命令关闭分页器。典型的是用命令more或less来实现逐页查看。缺省值是平台相关的。说明： less的文本显示，受系统环境变量LC_CTYPE影响。
PSQL_EDITOR	\e和\ef命令使用环境变量指定的编辑器。变量是按照列出的先后顺序检查的。在Unix系统上默认的编辑工具是vi。
EDITOR
VISUAL
PSQL_EDITOR_LINENUMBER_ARG	当\e和\ef带上一行数字参数使用时，这个变量指定的命令行参数用于向编辑器传递起始行数。像Emacs或vi这样的编辑器，这只是个加号。如果选项和行号之间需要空白，在变量的值后加一个空格。例如： PSQL_EDITOR_LINENUMBER_ARG = '+' PSQL_EDITOR_LINENUMBER_ARG='--line ' Unix系统默认的是+。
PSQLRC	用户的.gsqlrc文件的交互位置。
SHELL	使用\!命令跟shell执行的命令是一样的效果。
TMPDIR	存储临时文件的目录。缺省是/tmp。

使用指导

前提条件

连接数据库时使用的用户需要具备访问数据库的权限。

背景信息

使用gsql命令可以连接远程数据库服务。连接远程数据库服务时，需要在服务器上设置允许远程连接，详细操作请参见使用gsql访问openGauss。

操作步骤

使用gsql连接到openGauss服务器。

gsql工具使用-d参数指定目标数据库名、-U参数指定数据库用户名、-h参数指定主机名、-p参数指定端口号信息。
说明：
- 若未指定数据库名称，则使用初始化时默认生成的数据库名称；
- 若未指定数据库用户名，则默认使用当前操作系统用户作为数据库用户名；
- 当某个值没有前面的参数（-d、-U等）时，若连接的命令中没有指定数据库名（-d）则该参数会被解释成数据库名；
- 如果已经指定数据库名（-d）而没有指定数据库用户名（-U）时，该参数则会被解释成数据库用户名。
示例1，使用omm用户连接到本机postgres数据库的15400端口。
```
gsql -d postgres -p 15400
```
示例2，使用jack用户连接到远程主机postgres数据库的15400端口。
```
gsql -h 10.180.123.163 -d postgres -U jack -p 15400
```
示例3，参数postgres和omm不属于任何选项时，分别被解释成了数据库名和用户名。
```
gsql postgres omm -p 15400
```
等效于
```
gsql -d postgres -U omm -p 15400
```
详细的gsql参数请参见命令参考。
执行SQL语句。

以创建数据库human_staff为例。
```
CREATE DATABASE human_staff;
```
通常，输入的命令行在遇到分号的时候结束。如果输入的命令行没有错误，结果就会输出到屏幕上。

执行gsql元命令。

以列出openGauss中所有的数据库和描述信息为例。

openGauss=#  \l
                                List of databases
      Name      |  Owner   | Encoding  | Collate | Ctype |   Access privileges   
----------------+----------+-----------+---------+-------+-----------------------
 human_resource | omm | SQL_ASCII | C       | C     | 
 postgres       | omm | SQL_ASCII | C       | C     | 
 template0      | omm | SQL_ASCII | C       | C     | =c/omm         +
                |          |           |         |       | omm=CTc/omm
 template1      | omm | SQL_ASCII | C       | C     | =c/omm          +
                |          |           |         |       | omm=CTc/omm
 human_staff    | omm | SQL_ASCII | C       | C     | 
(5 rows)