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

注意事项

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

前提条件

已确认连接信息。

本地连接数据库

以操作系统用户omm登录CN所在主机，执行source ${BIGDATA_HOME}/mppdb/.mppdbgs_profile命令启动环境变量。
连接数据库。
数据库安装完成后，默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。
执行如下命令连接数据库。
```
gsql -d postgres -p 25308
```
```
其中postgres为需要连接的数据库名称，25308为CN的端口号。请根据实际情况替换。
```
连接成功后，系统显示类似如下信息：
```
gsql ((GaussDB Kernel V300R002C00 build 50dc16a6) compiled at 2019-01-29 05:49:21 commit 1071 last mr 1373)
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.
postgres=#
```
omm用户是管理员用户，因此系统显示“DBNAME=#”。若使用普通用户身份登录和连接数据库，系统显示“DBNAME=>”。
“Non-SSL connection”表示未使用SSL方式连接数据库。如果需要高安全性时，请使用SSL连接。
退出数据库。
```
\q
```
```
远程连接数据库
```

完成远程连接配置，操作步骤参见配置服务端远程连接。
在客户端机器（10.10.0.30）上，上传客户端工具包并配置gsql的执行环境变量。
1. 以root用户登录客户端机器。
2. 创建“/tmp/tools”目录。
```
mkdir /tmp/tools
```
```
获取软件安装包中的“GaussDB-Kernel-VxxxRxxxCxx-SUSExx-64bit-ClientTools.tar.gz”上传到“/tmp/tools”路径下。
```
3. 说明：
  - 软件包相对位置为安装时所放位置，根据实际情况填写。
  - 不同的操作系统，工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。
4. 解压文件。
```
cd /tmp/tools
tar -zxvf GaussDB-Kernel-VxxxRxxxCxx-SUSExx-64bit-ClientTools.tar.gz
```
5. 设置环境变量。
  打开“~/.bashrc”文件。
```
vi ~/.bashrc
```
```
在其中输入如下内容后，使用“:wq!”命令保存并退出。
```
```
export PATH=/tmp/tools/bin:$PATH
export LD_LIBRARY_PATH=/tmp/tools/lib:$LD_LIBRARY_PATH
```
6. 使环境变量配置生效。
```
source ~/.bashrc
```
```
连接数据库。
```
数据库安装完成后，默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。
```
gsql -d postgres -h 10.10.0.11 -U jack -p 25308 -W Gaussdba@Mpp
```
```
postgres为需要连接的数据库名称，10.10.0.11为CN所在的服务器IP地址，jack为连接数据库的用户，25308为CN的端口号，Gaussdba@Mpp为连接数据库用户jack的密码。
```
说明：
- 连接GaussDB 200的机器与GaussDB 200不在同一网段时，-h指定的IP地址应为Manager界面上所设的mppdb.coo.cooListenIp2（应用访问IP）的取值。
- 禁止使用omm用户进行远程连接数据库。

ITPub博客

连接数据库-使用gsql连接

注意事项

前提条件

本地连接数据库

最新文章