使用 gsql 客户端连接集群

用户在创建好数据仓库集群，开始使用集群数据库之前，需要使用数据库SQL客户端 连接到数据库。GaussDB(DWS) 提供了与集群版本配套的gsql命令行客户端工具，您 可以使用gsql客户端通过集群的公网地址或者内网地址访问集群。

使用 gsql 命令行客户端连接集群

步骤1 准备一个Linux弹性云服务器，用于安装和运行gsql客户端。

具体操作请参见准备ECS作为gsql客户端主机。

步骤2 请参见下载客户端下载gsql客户端，并使用SSH文件传输工具（例如WinSCP工具），

将客户端工具上传到一个待安装gsql的Linux主机上。

执行上传gsql操作的用户需要对客户端主机的目标存放目录有完全控制权限。

或者，您也可以先SSH远程登录到需要安装gsql的Linux主机，然后在Linux命令窗口，

执行以下命令下载gsql客户端：

wget https://obs.cn-north-1.myhuaweicloud.com/dws/download/dws_client_8.1.x_redhat_x64.zip --no-check-certificate

步骤3 使用SSH会话工具，远程登录客户端主机。

弹性云服务器的登录方法请参见《弹性云服务器用户指南》中的SSH密码方式登录章 节。

步骤4 （可选）如果要使用SSL方式连接集群，请参考使用SSL进行安全的TCP/IP连接章节，

在客户端主机配置SSL认证相关的参数。

说明

SSL连接方式的安全性高于非SSL方式，建议在客户端使用SSL连接方式。

步骤5 执行以下命令解压客户端工具。

cd <客户端存放路径>

unzip dws_client_8.1.x_redhat_x64.zip

其中：

● <客户端存放路径>：请替换为实际的客户端存放路径。

● dws_client_8.1.x_redhat_x64.zip：这是“RedHat x64”对应的客户端工具包名 称，请替换为实际下载的包名。

步骤6 执行以下命令配置客户端。

source gsql_env.sh

提示以下信息表示客户端已配置成功

All things done.

步骤7 执行以下命令，使用gsql客户端连接GaussDB(DWS) 集群中的数据库。

gsql -d <数据库名称> -h <集群地址> -U <数据库用户> -p <数据库端口> -r

例如，执行以下命令连接GaussDB(DWS) 集群的默认数据库gaussdb：

gsql -d gaussdb -h 10.168.0.74 -U dbadmin -p 8000 -r

根据界面提示输入密码后，显示如下信息表示gsql工具已经连接成功：

GaussDB(DWS) 支持用户将数据从集群外导入到集群中。用户可以参考以下指导，快 速将样例数据从OBS导入集群，并对样例数据进行查询和分析。导入的样例数据是使 用TPC-DS测试基准生成的标准性能测试数据。

TPC-DS是数据库决策支持测试基准。通过使用TPC-DS的测试数据以及测试案例，用户 可以模拟真实场景下大数据集的统计、报表生成、联机查询、数据挖掘等复杂场景，

从而了解数据库应用的功能和性能。

说明

当前TPC-DS样例数据仅支持在“北京一”区域导入，其他区域暂不支持。

步骤1 使用SSH远程连接工具登录gsql客户端主机，并进入gsql目录，本例假设gsql客户端放 在/opt目录下。

cd /opt

步骤2 执行以下命令，切换到指定目录并设置用户导入样例数据的用户密钥和OBS访问地 址。

cd sample

/bin/bash setup.sh -ak <Access_Key_Id> -sk <Secret_Access_Key> -obs_location obs.cn-north-1.myhuaweicloud.com

系统显示以下信息表示设置成功：

setup successfully!

说明

<Access_Key_Id>和<Secret_Access_Key>：分别表示访问密钥ID和私有访问密钥。请参见创建访 问密钥（AK和SK）进行获取。然后将获取到的值替换到创建外表语句中。

步骤3 返回上一级目录，执行gsql环境变量。

cd ..

source gsql_env.sh cd bin

gsql -d gaussdb -h 10.168.0.74 -U dbadmin -p 8000 -f /opt/sample/tpcds_load_data_from_obs.sql -r 说明

命令中样例数据脚本“tpcds_load_data_from_obs.sql”存放在GaussDB(DWS) 客户端的 sample目录下，如“/opt/sample/”。

Time:1845600.524 ms

步骤5 在Linux命令窗口，执行以下命令，切换到指定目录并查询样例数据。

cd /opt/sample/query_sql/

/bin/bash tpcds100x.sh

步骤6 根据命令提示，输入集群公网访问地址的IP地址、数据库端口、数据库名称、数据库 访问用户以及用户密码。

● 数据库名称默认为“gaussdb”。

● 数据库访问用户和密码使用创建集群时配置的管理员用户和密码。

查询完成后，在当前查询目录，如“sample/query_sql/”下面会生成一个存放查询结 果的目录，命名如“query_output_20170914_072341”。

----结束