安装gsql客户端并连接数据库

gsql是openGauss提供的在命令行下运行的数据库连接工具。此工具除了具备操作数据库的基本功能，还提供了若干高级特性，便于用户使用。本节只介绍如何安装gsql客户端，使用gsql客户端连接数据库，更多配置请参见openGauss产品文档。

前提条件

已确认连接信息。

操作步骤

在客户端机器上，上传客户端工具包并配置gsql的执行环境变量。

  1. 以root用户登录客户端机器。

  2. 创建“/tmp/tools”目录。

    1. mkdir /tmp/tools

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

    安装gsql客户端并连接数据库 - 图1 说明：
    - 软件包相对位置为安装时所放位置，根据实际情况填写。
    - 不同的操作系统，工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。

  4. 解压文件。

    1. cd /tmp/tools
    2. tar -zxvf openGauss-1.0.0-openEuler-64bit-Libpq.tar.gz

  5. 设置环境变量。

    打开“~/.bashrc”文件。

    1. vi ~/.bashrc

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

    1. export PATH=/tmp/tools/bin:$PATH
    2. export LD_LIBRARY_PATH=/tmp/tools/lib:$LD_LIBRARY_PATH

  6. 使环境变量配置生效。

    1. source ~/.bashrc

  7. 连接数据库。

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

    1. gsql -d postgres -h 10.10.0.11 -U jack -p 8000 -W Test@123

    postgres为需要连接的数据库名称，10.10.0.11为数据库主节点所在的服务器IP地址，jack为连接数据库的用户，8000为数据库主节点的端口号，Test@123为连接数据库用户jack的密码。

    安装gsql客户端并连接数据库 - 图2 说明：
    - 连接openGauss的机器与openGauss不在同一网段时，-h指定的IP地址应为Manager界面上所设的coo.cooListenIp2（应用访问IP）的取值。
    - 禁止使用omm用户进行远程连接数据库。