点击上方“IT那活儿”公众号–专注于企业全栈运维技术分享，不管IT什么活儿，干就完了！！！
gsql简介
官网地址：工具简介_数据仓库服务 GaussDB(DWS)_华为云
https://support.huaweicloud.com/tg-dws/dws_07_0001.html
一款运行在Linux操作系统的命令行工具，用于连接DWS集群中的数据库，并对数据库进行操作和维护。
-
通过gsql客户端远程连接GaussDB(DWS)数据库。
-
支持交互式地键入并执行SQL语句，也可以执行一个文件中指定的SQL语句。
-
元命令可以帮助管理员查看数据库对象的信息、查询缓存区信息、格式化SQL输出结果，以及连接到新的数据库等。元命令的详细说明请参见元命令参考
https://support.huaweicloud.com/tg-dws/dws_gsql_007.html#ZH-CN_TOPIC_0000001813598728
GaussDB基于PostgreSQL开发，基础功能和PostgreSQL一样，可以优先了解PostgreSQL的操作。
PostgreSQL官网文档：PostgreSQL: Documentation: 17: PostgreSQL 17.5 Documentation。
新GaussDB(DWS)集群版本为 8.2.13，对应的gsql版本为 8.2。
登录公有云控制台，进入DWS产品页面下载。根据操作系统版本选择下载链接，本文档使用系统为64位CentOS 7。
链接：https://obs.myhuaweicloud.com/dws/download/dws_client_8.2.x_redhat_x64.zip
GaussDB（DWS）工具指南 > gsql > 下载客户端页面下载。根据操作系统版本选择下载链接，本文档使用系统为64位CentOS 7。
链接：https://obs.cn-north-1.myhuaweicloud.com/dws/download/dws_client_8.2.x_redhat_x64.zip
除GaussDB（dws）版本外，下载链接的选择考虑两个因素：操作系统发行版本、操作系统架构。其中操作系统发行版本对应关系参照官网发行版参考（可选）准备ECS作为gsql客户端主机章节https://support.huaweicloud.com/tg-dws/dws_gsql_009.html。
Linux下部署
官网文档：使用Linux gsql客户端连接集群_数据仓库服务 GaussDB(DWS)_华为云https://support.huaweicloud.com/tg-dws/dws_gsql_009.html
下载后上传物料到服务器，本文档使用weblogic用户登录CentOS虚拟机，安装在/home/weblogic目录中。
解压物料，其中目录 `/home/weblogic/gs_client` 为gsql客户端存放路径，按需调整。命令参考：
# 创建客户端存放路径mkdir -p /home/weblogic/gs_client/# 解压unzip dws_client_8.2.x_redhat_x64.zip -d /home/weblogic/gs_client# 进入解压目录 cd gs_client# 查看解压结果ll
gsql使用
3.1 使用 `–help` 命令，查看 gsql 用法
gsql --helpUsage: gsql [OPTION]... [DBNAME [USERNAME]] ... ... ...Connection options: -h, --host=HOSTNAME database server host or socket directory (default:"local socket") -p, --port=PORT database server port (default:"5432") -U, --username=USERNAME database user name (default:"weblogic") -W, --password=PASSWORD the password of specified database user
其中 `Connection options` 为链接参数，使用各分省自己的GaussDB集群IP、端口、用户、数据库、密码进行链接。
gsql -h 9.3.5.55 -p 25308 -d hbfsdb -U nuser1300 -W'xxxx'
gsql -h 9.*.*.* -p 25308 -d * -U * -W'xxxx'
gsql: error while loading shared libraries: libpq.so.5: cannot open shared object file: No such file or directory
未设置环境变量，需要引入环境变量才能使用gsql。
gsql: could not connect to server: Operation now in progress
`telnet ip port` 查看端口连通性。
夜雨聆风
