使用gsql连接

gsql是openGauss提供的在命令行下运行的数据库连接工具。此工具除了具备操作数据库的基本功能，还提供了若干高级特性，便于用户使用。本节只介绍如何使用gsql连接数据库，关于gsql使用方法的更多信息请参考《工具参考》中“客户端工具 > gsql”章节。

注意事项

缺省情况下，客户端连接数据库后处于空闲状态时会根据参数session_timeout的默认值自动断开连接。如果要关闭超时设置，设置参数session_timeout为0即可。

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

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

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

连接成功后，系统显示类似如下信息：
```
gsql ((openGauss 1.0.1 build 290d125f) compiled at 2020-05-08 02:59:43 commit 2143 last mr 131
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.
postgres=#
```
omm用户是管理员用户，因此系统显示“DBNAME=#”。若使用普通用户身份登录和连接数据库，系统显示“DBNAME=>”。

“Non-SSL connection”表示未使用SSL方式连接数据库。如果需要高安全性时，请使用SSL连接。
首次登录需要修改密码。原始密码为安装openGauss数据库手动输入的密码，具体请参见《安装指南》中”安装openGauss > 执行安装”章节，此处需将原始密码修改为自定义的密码，例如Mypwd123，命令如下：
```
ALTER ROLE omm IDENTIFIED BY 'Mypwd123' REPLACE 'XuanYuan@2012';
```
退出数据库。
```
\q
```

以root用户登录客户端机器。创建“/tmp/tools”目录。


   mkdir /tmp/tools

获取软件安装包中的“openGauss-1.0.1-openEuler-64bit-Libpq.tar.gz”上传到“/tmp/tools”路径下。

软件包相对位置为安装时所放位置，根据实际情况填写。
不同的操作系统，工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。

解压文件。

   cd /tmp/tools
   tar -zxvf openGauss-1.0.1-openEuler-64bit-Libpq.tar.gz

登录数据库主节点所在的服务器，拷贝数据库安装目录下的bin目录到客户端主机的“/tmp/tools”路径下。其中，/opt/huawei/install/app为clusterconfig.xml文件中配置的{gaussdbAppPath}路径，10.10.0.30为客户端主机ip。

   scp -r /opt/huawei/install/app/bin root@10.10.0.30:/tmp/tools

登录客户端主机，设置环境变量。打开“~/.bashrc”文件。

   vi ~/.bashrc

在其中输入如下内容后，使用“:wq!”命令保存并退出。

   export PATH=/tmp/tools/bin:$PATH
   export LD_LIBRARY_PATH=/tmp/tools/lib:$LD_LIBRARY_PATH

使环境变量配置生效。

   source ~/.bashrc