使用gsql访问openGauss

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

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

  2. 连接数据库。

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

    执行如下命令连接数据库。

    1. gsql -d postgres -p 8000

    其中postgres为需要连接的数据库名称，8000为数据库主节点的端口号。请根据实际情况替换。

    连接成功后，系统显示类似如下信息：

    1. gsql((openGauss x.x.x build f521c606) compiled at 2021-09-16 14:55:22 commit 2935 last mr 6385 release)
    2. Non-SSL connection (SSL connection is recommended when requiring high-security)
    3. Type "help" for help.
    5. openGauss=#

    omm用户是管理员用户，因此系统显示“DBNAME=#”。若使用普通用户身份登录和连接数据库，系统显示“DBNAME=>”。提示符告诉您openGauss准备为您输入SQL语句。

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

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

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

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

    gsql程序有一些不属于SQL命令的内部命令。它们以反斜线开头“\”。例如：

    • 您可以用下面的命令查询openGauss的版本和版权信息。

      1. openGauss=# \copyright

    • 您可以用下面的命令获取各种openGauss的SQL命令的帮助语法。

      1. openGauss=# \h

    • 您可以用下面的命令查询openGauss中所有的数据库和描述信息。

      1. openGauss=# \l

  5. 退出数据库。

    1. openGauss=# \q

    缺省情况下，客户端连接数据库后处于空闲状态时间超过参数session_timeout的默认值（10min）时会自动断开连接。