文档首页 > > 管理指南> 连接集群> 使用gsql命令行客户端连接集群> 使用gsql客户端连接集群

使用gsql客户端连接集群

分享
更新时间: 2019/10/30 GMT+08:00

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

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

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

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

  2. 请参见下载客户端下载gsql客户端,并使用SSH文件传输工具(例如WinSCP工具),将客户端工具上传到一个待安装gsql的Linux主机上。

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

    或者,您也可以在SSH远程登录待安装gsql的Linux主机后,在Linux命令窗口,执行以下命令下载gsql客户端:

    wget https://obs.myhwclouds.com/dws/download/dws_client_redhat_x64.tar.gz --no-check-certificate

  3. 使用SSH会话工具,远程登录客户端主机。

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

  4. (可选)如果要使用SSL方式连接集群,请参考使用SSL进行安全的TCP/IP连接章节,在客户端主机配置SSL认证相关的参数。

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

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

    cd <客户端存放路径>

    tar -xvf dws_client_redhat_x64.tar.gz

    其中:

    • <客户端存放路径>:请替换为实际的客户端存放路径。
    • dws_client_redhat_x64.tar.gz:这是“RedHat x64”对应的客户端工具包名称,请替换为实际下载的包名。

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

    source gsql_env.sh

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

    All things done.

    配置后可以马上使用客户端连接DWS集群。

  7. 执行以下命令,使用gsql客户端连接DWS集群中的数据库。

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

    参数说明如下:

    • “数据库名称”:输入所要连接的数据库名称。首次使用客户端连接集群时,请指定为集群的默认数据库“postgres”
    • “集群地址”:请参见获取集群连接地址进行获取。如果通过公网地址连接,请指定为集群“公网访问地址”“公网访问域名”,如果通过内网地址连接,请指定为集群“内网访问地址”“内网访问域名”
    • “数据库用户”:输入集群数据库的用户名。首次使用客户端连接集群时,请指定为创建集群时设置的默认管理员用户,例如“dbadmin”
    • “数据库端口”:输入创建集群时设置的“数据库端口”

    例如,执行以下命令连接DWS集群的默认数据库postgres:

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

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

    1
    postgres=>
    

gsql命令参考

有关gsql的命令参考和更多信息,请参见《数据仓库服务工具指南》

(可选)使用gsql导入TPC-DS样例数据

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

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

  1. 使用SSH远程连接工具登录gsql客户端主机。
  2. 在Linux命令窗口,执行以下命令,切换到指定目录并设置用户导入样例数据的用户密钥和OBS访问地址。

    cd ./sample

    /bin/bash setup.sh -ak <Access_Key_Id> -sk <Secret_Access_Key> -obs_location obs.myhwclouds.com

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

    setup successfully!

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

  3. 在Linux命令窗口,执行以下命令,将样例数据导入数据仓库。

    命令格式:

    gsql -d <数据库名称> -h <集群公网访问地址> -U <管理员用户> -p <数据仓库端口> -f <样例数据脚本保存路径> -r

    命令示例:

    gsql -d postgres -h 10.168.0.74 -U dbadmin -p 8000 -f tpcds_load_data_from_obs.sql -r

    命令中样例数据脚本“tpcds_load_data_from_obs.sql”存放在DWS客户端的sample目录下,如“dws_client_redhat_x64\sample”

    根据界面提示输入管理员密码,成功连接集群数据库后,系统会自动创建样例数据对应的外表用于关联集群外的数据,然后再创建存放样例数据的目标表,最后通过外表将数据导入到目标表中。

    系统显示如下执行时间信息表示导入成功,如下时间仅为示例。

    Time:1845600.524 ms

  1. 在Linux命令窗口,执行以下命令,切换到指定目录并查询样例数据。

    cd sample/query_sql/

    /bin/bash tpcds100x.sh

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

    • 数据库名称默认为“postgres”
    • 数据库访问用户和密码使用创建集群时配置的管理员用户和密码。

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

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区