文档首页 > > 快速入门> GaussDB(openGauss)快速入门> 通过内网连接GaussDB(openGauss)实例> 步骤三:通过gsql连接实例

步骤三:通过gsql连接实例

分享
更新时间:2020/07/22 GMT+08:00

gsql是GaussDB(openGauss)提供的在命令行下运行的数据库连接工具。

准备工作

通过弹性云服务器连接GaussDB(openGauss)实例,您需要创建一台弹性云服务器。

创建并连接ECS,请参见如何创建和连接ECS。此处以Euler操作系统为例。

远程连接数据库

  1. 登录申请的弹性云服务器。
  2. 在申请的弹性云服务器上,上传客户端工具包并配置gsql的执行环境变量。

    1. 以root用户登录客户端机器。
    2. 创建“/tmp/tools”目录。
      mkdir /tmp/tools
    3. 获取此处的“GaussDB-Kernel-xxx-EULER-64bit-gsql.tar.gz”上传到“/tmp/tools”路径下。
      • 软件包相对位置为安装时所放位置,根据实际情况填写。
      • 不同的操作系统、版本,工具包文件名称会有差异。请根据实际的操作系统类型选择对应的工具包。
    4. 解压文件。
      cd /tmp/tools
      tar -zxvf GaussDB-Kernel-V500R001C00-EULER-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.0.0.0 -U jack -p 8000 -W Test@123

    postgres为需要连接的数据库名称,10.0.0.0为CN所在的服务器IP地址,jack为登录数据库的用户名,8000为CN的端口号,Test@123为登录数据库用户jack的密码。

    • 上述示例中,jack用户为数据库初始化用户创建的普通用户。
    • 禁止使用数据库初始化用户进行远程连接数据库。

SSL连接

  1. 登录管理控制台。
  2. 单击管理控制台左上角的,选择区域和项目。
  3. 选择数据库 > 云数据库 RDS。进入云数据库 RDS信息页面。
  4. “实例管理”页面,单击实例名称进入“基本信息”页面,单击“数据库信息”模块“SSL”处的,下载根证书或捆绑包。
  5. 将根证书上传至需连接GaussDB(openGauss)实例的弹性云服务器,或保存到可访问华为云关系型数据库实例的设备。

    将根证书导入弹性云服务器Linux操作系统,请参见将根证书导入Windows/Linux操作系统

  6. 连接华为云关系型数据库实例。以Linux系统为例,设置环境变量,执行如下命令。

    export PGSSLMODE=<sslmode>
    export PGSSLROOTCERT=<ca-file-directory>

    gsql -h <host> -p <port> -d <database> -U <user> -W <password>

    表1 参数说明

    参数

    说明

    <host>

    主机IP,在“实例管理”页面单击实例名称,进入“基本信息”页面。“连接信息”模块的“内网地址”(通过弹性云服务器访问)。

    <port>

    端口,默认8000,当前端口,即在“实例管理”页面单击实例名称,进入“基本信息”页面,“连接信息”模块的“数据库端口”

    <database>

    需要连接的数据库名,默认管理数据库是postgres。

    <user>

    用户名,即华为云关系型数据库帐号,默认管理员帐号为root。

    <ca-file-directory>

    ssl连接CA证书路径,该文件需放在执行该命令的路径下。

    <sslmode>

    ssl连接模式,设置为“verify-ca”,通过检查证书链(Certificate Chain,以下简称CA)来验证服务是否可信任。

    设置环境变量,使用root用户SSL连接postgres数据库实例,示例如下:

    export PGSSLMODE="verify-ca"
    export PGSSLROOTCERT="/home/Ruby/ca.pem"

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

  7. 登录数据库后,出现如下信息,表示通过SSL连接成功。

    SSL connection (cipher: DHE-RSA-AES256-GCM-SHA384, bits: 256)

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问