通过公网连接实例

GaussDB(for openGauss)实例创建成功后，默认未开启公网访问功能（即未绑定弹性 公网IP）。GaussDB(for openGauss)支持用户绑定弹性公网IP，在公共网络来访问数 据库实例，绑定后也可根据需要解绑。

用户指南 4 使用客户端连接实例

准备工作

GaussDB(for openGauss)提供gsql工具帮助您在命令行下连接数据库，您需要提前创 建一台弹性云服务器用于安装gsql工具。

创建并连接ECS，请参见弹性云服务器快速入门。

须知

操作系统需要选择Euler操作系统。gsql支持的操作系统版本如下：

X86：EulerOS V2.0SP5。

鲲鹏服务器：EulerOS V2.0SP8。

绑定弹性公网 IP

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

mkdir /tmp/tools

3. 单击此处获取GaussDB(for openGauss)软件包并解压。

unzip GaussDB_opengauss_client_tools.zip

4. 根据申请的弹性云服务器的操作系统架构进入不同目录，获取“GaussDB-Kernel-xxx-EULER-64bit-gsql.tar.gz”，并上传到申请的弹性云服务器“/tmp/tools”路 径下。

说明

软件包相对位置为安装时所放位置，根据实际情况填写。

5. 解压文件。

cd /tmp/tools

tar -zxvf GaussDB-Kernel-V500R001C00-EULER-64bit-gsql.tar.gz

6. 设置环境变量。

打开“~/.bashrc”文件。

vi ~/.bashrc

在其中输入如下内容后，单击“ESC”退出编辑模式，使用“:wq!”命令保存并退 出。

export PATH=/tmp/tools/bin:$PATH

export LD_LIBRARY_PATH=/tmp/tools/lib:$LD_LIBRARY_PATH

用户指南 4 使用客户端连接实例

使环境变量配置生效。

source ~/.bashrc

步骤3 执行如下指令，根据提示输入密码，连接数据库。

数据库创建成功后，会默认生成名称为postgres的数据库。

gsql -d postgres -h 10.0.0.0 -U root -p 8000 Password for user root:

postgres为需要连接的数据库名称，10.0.0.0为实例绑定的公网IP地址，root为登录数

步骤3 将根证书上传至需连接GaussDB(for openGauss)实例的弹性云服务器，或保存到可访 问数据库实例的设备。

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

步骤4 连接GaussDB(for openGauss)实例。以Linux系统为例，设置环境变量，执行如下命 令。

export PGSSLMODE=<sslmode>

export PGSSLROOTCERT=<ca-file-directory>

gsql -h

-p

-d

表

4-3 参数说明

参数 说明

<host> 主机IP，在“实例管理”页面单击实例名称，进入“基本信息”页

面。“连接信息”模块的“内网地址”（通过弹性云服务器访 问）。

<port> 端口，默认8000，当前端口，即在“实例管理”页面单击实例名

称，进入“基本信息”页面，“连接信息”模块的“数据库端 口”。

<database> 需要连接的数据库名，默认管理数据库是postgres。

<user> 用户名，即GaussDB(for openGauss)数据库帐号，默认管理员帐

号为root。

<ca-file-directory> ssl连接CA证书路径。

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

用户指南 4 使用客户端连接实例

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

export PGSSLMODE="verify-ca"

export PGSSLROOTCERT="/home/Ruby/ca.pem"

gsql -d

Password for user root:

步骤5 登录数据库后，出现如下信息，表示通过SSL连接成功。

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

----结束

用户指南 4 使用客户端连接实例

5 ^{使用驱动连接实例}

本章主要介绍如何使用JDBC、ODBC等驱动连接实例。