gsql连接与使用方法

gsql连接与使用方法

openGauss提供了在命令行下运行的数据库连接工具gsql。此工具除了具备操作数据库的基本功能，还提供了若干高级特性，便于用户使用。本节主要介绍如何使用gsql本地连接数据库。您需要提供数据库的名称以及数据库主节点的端口号。

以操作系统用户omm登录数据库主节点。
连接数据库。

数据库安装完成后，默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。

执行如下命令连接数据库。
```
gsql -d postgres -p 8000
```
其中postgres为需要连接的数据库名称，8000为数据库主节点的端口号。请根据实际情况替换。

连接成功后，系统显示类似如下信息：
```
gsql((openGauss x.x.x build f521c606) compiled at 2021-09-16 14:55:22 commit 2935 last mr 6385 release)
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.
openGauss=#
```
omm用户是管理员用户，因此系统显示“DBNAME=#”。若使用普通用户身份登录和连接数据库，系统显示“DBNAME=>”。提示符告诉您openGauss准备为您输入SQL语句。

“Non-SSL connection”表示未使用SSL方式连接数据库。

首次登录建议修改密码以提高安全性。命令如下。

openGauss=# ALTER ROLE omm IDENTIFIED BY 'XXXXXXXX' REPLACE 'XXXXXXXX';

说明：

最少包含8个字符；
不能和用户名和当前密码相同，或和当前密码反序；
至少包含大写字母（A-Z），小写字母（a-z），数字，非字母数字字符（限定为~!@#$%^&*()-_=+|[{}];:,<.>/?）四类字符中的三类字符；
安装过程中会生成ssl证书，证书存放路径为{gaussdbAppPath}/share/sslcert/om，其中{gaussdbAppPath}为集群openGauss配置文件中指定的程序安装目录。

gsql提供了高级功能方便您使用数据库。

gsql程序有一些不属于SQL命令的元命令。它们以反斜线开头，“\”。例如：
- 您可以用下面的命令查询openGauss的版本和版权信息。
```
openGauss=# \copyright
```
- 您可以用下面的命令获取各种openGauss的SQL命令的帮助语法。
```
openGauss=# \h
```
- 您可以用下面的命令查询openGauss中所有的数据和描述信息。
```
openGauss=# \l
```
退出数据库。
```
openGauss=# \q
```
缺省情况下，客户端连接数据库后处于空闲状态时间超过参数session_timeout的默认值（10min）时会自动断开连接。