对于gsql的使用

---

前提条件

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

---

背景信息

使用gsql命令可以连接远程数据库服务。连接远程数据库服务时，需要在服务器上设置允许远程连接。

---

操作步骤

1. 使用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

2. 执行SQL语句。
   创建数据库human_staff为例。

CREATE DATABASE human_staff;
CREATE DATABASE

通常，输入的命令行在遇到分号的时候结束。如果输入的命令行没有错误，结果就会输出到屏幕上。

3. 执行gsql元命令。
   以列出openGauss中所有的数据库和描述信息为例。

ostgres=# \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)

---