更新时间:2024-11-27 GMT+08:00
分享

使用gsql连接

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

注意事项

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

前提条件

已联系管理员获取连接信息。

远程连接数据库

  1. 完成远程连接配置,请联系管理员处理
  2. 在客户端机器上,上传客户端工具包并配置gsql的执行环境变量。

    1. 登录客户端机器。
    2. 创建“/tmp/tools”目录。
      mkdir /tmp/tools
    3. 获取软件安装包中的“GaussDB-Kernel_VxxxRxxxCxx-xxxxx-64bit-gsql.tar.gz”上传到“/tmp/tools”路径下。
      • 软件包相对位置为安装时所放位置,根据实际情况填写。
      • 不同的操作系统,工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。
    4. 解压文件。
      cd /tmp/tools
      tar -zxvf GaussDB-Kernel_VxxxRxxxCxx-XXXXX-64bit-gsql.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

  3. 连接数据库。

    数据库安装完成后,会默认生成名称为postgres的数据库。

    gsql -d postgres -h 10.10.0.11 -U jack -p 8000
    Password for user jack:

    postgres为需要连接的数据库名称,10.10.0.11为CN所在的服务器IP地址,jack为登录数据库的用户名,8000CN的端口号,上述示例中,连接的服务器的IP和端口也可以替换成DN服务器IP和端口。

    • 上述示例中,jack用户为数据库初始化用户创建的普通用户。
    • 默认禁止使用数据库初始化用户进行远程连接数据库,开启集群内部kerberos认证时,允许初始化用户在集群内部进行远程连接。

相关文档