文档简介：
用户在创建好数据仓库集群，开始使用集群数据库之前，需要使用数据库SQL客户端连接到数据库。DWS提供了与集群版本配套的Linux gsql命令行客户端工具，您可以使用Linux gsql客户端通过集群的公网地址或者内网地址访问集群。
它的运行环境是Linux操作系统，在使用Linux gsql客户端远程连接DWS集群之前，需要准备一个Linux主机用于安装和运行Linux gsql客户端。如果通过公网地址访问集群，也可以将Linux gsql客户端安装在用户自己的Linux主机上，但是该Linux主机必须具有公网地址。若DWS集群没有配置公网IP，为方便起见，推荐您创建一台Linux弹性云主机（简称ECS）。
（可选）准备ECS作为gsql客户端主机
创建弹性云主机的操作步骤，请参见《弹性云主机用户指南》中的“快速入门 > 创建弹性云主机”章节。
创建的弹性云主机需要满足如下要求：
- 弹性云主机需要与DWS 集群具有相同的区域、可用区。
- 如果使用DWS 提供的gsql命令行客户端连接DWS 集群，弹性云主机的镜像必须满足如下要求：
镜像的操作系统必须是gsql客户端所支持的下列Linux操作系统：
−“Redhat x86_64”客户端工具支持在以下系统中使用：
RHEL 6.4~7.6
CentOS 6.4~7.4
EulerOS 2.3
−“SUSE x86_64”客户端工具支持在以下系统中使用：
SLES 11.1~11.4
SLES 12.0~12.3
- 如果客户端通过内网地址访问集群，请确保创建的弹性云主机与DWS 集群在同一虚拟私有云里。
虚拟私有云相关操作请参见《虚拟私有云用户指南》中“虚拟私有云和子网”。
- 如果客户端通过公网地址访问集群，请确保创建的弹性云主机和DWS 集群都要有弹性IP。
创建弹性云主机时，参数“弹性IP”需设置为“自动分配”或“使用已有”。
- 弹性云主机对应的安全组规则需要确保能与DWS 集群提供服务的端口网络互通。
安全组相关操作请参见《虚拟私有云用户指南》中“安全组”章节。
请确认弹性云主机的安全组中存在符合如下要求的规则，如果不存在，请在弹性云主机的安全组中添加相应的规则：
−方向：出方向
−协议：必须包含TCP，例如TCP、全部。
−端口：需要包含DWS 集群提供服务的数据库端口，例如，设置为“1-65535”或者具体的DWS 数据库端口。
−目的地址：设置的IP地址需要包含所要连接的DWS集群的地址，例如，设置为“0.0.0.0/0”或者具体的DWS 集群的连接地址。
- DWS 集群的安全组规则需要确保DWS 能接受来自客户端的网络访问。
请确认DWS 集群的安全组中存在符合如下要求的规则，如果不存在，请在DWS 集群的安全组中添加相应的规则。
−方向：入方向
−协议：必须包含TCP，例如TCP、全部。
−端口：设置为DWS 集群提供服务的数据库端口，例如“8000”。
−源地址：设置的IP地址需要包含DWS 客户端主机的IP地址，例如“192.168.0.10/32”。
下载Linux gsql客户端并连接集群
- 下载客户端下载Linux gsql客户端，并使用SSH文件传输工具（例如WinSCP工具），将客户端工具上传到一个待安装Linux gsql的Linux主机上。
执行上传Linux gsql操作的用户需要对客户端主机的目标存放目录有完全控制权限。
- 使用SSH会话工具，远程登录客户端主机。
弹性云主机的登录方法请参见《弹性云主机用户指南》中的“实例 > 登录Linux弹性云主机 > SSH密码方式登录”章节。
- （可选）如果要使用SSL方式连接集群，请参考 使用SSL进行安全的TCP/IP连接章节，在客户端主机配置SSL认证相关的参数。
SSL连接方式的安全性高于非SSL方式，建议在客户端使用SSL连接方式。
- 执行以下命令解压客户端工具。
cd <客户端存放路径>
unzip dws_client_8.1.x_redhat_x64.zip
其中：
- <客户端存放路径>：请替换为实际的客户端存放路径。
- dws_client_ 8.1.x _redhat_x64.zip：这是“RedHat x64”对应的客户端工具包名称，请替换为实际下载的包名。
- 执行以下命令配置客户端。
source gsql_env.sh
提示以下信息表示客户端已配置成功：
All things done.
- 执行以下命令，使用gsql客户端连接DWS 集群中的数据库。
gsql -d <数据库名称>
-h <集群地址> -U <数据库用户> -p <数据库端口> -r
参数说明如下：
- “数据库名称”：输入所要连接的数据库名称。首次使用客户端连接集群时，请指定为集群的默认数据库“gaussdb”。
- “集群地址”：请参见 获取集群连接地址进行获取。如果通过公网地址连接，请指定为集群“公网访问地址”或“公网访问域名”，如果通过内网地址连接，请指定为集群“内网访问地址”或“内网访问域名”。
- “数据库用户”：输入集群数据库的用户名。首次使用客户端连接集群时，请指定为创建集群时设置的默认管理员用户，例如“dbadmin”。
- “数据库端口”：输入创建集群时设置的“数据库端口”。
例如，执行以下命令连接DWS
集群的默认数据库gaussdb：
gsql -d gaussdb -h 10.168.0.74 -U dbadmin -p 8000 -W password -r
显示如下信息表示gsql工具已经连接成功：
gaussdb=>
