ARTICLE · 1040273
gsql安装部署文档
gsql安装部署文档点击上方“IT那活儿”公众号--专注于企业全栈运维技术分享，不管IT什么活儿，干就完了！！！ 1.1 官网地址 工具简介_数据仓库服务 GaussDB(DWS)_华为云：https://support.huaweicloud.com/tg-dws/dws_07_0001.html 一款运行在Linux操作系统的命令行工具，用于连接DWS集群中的数据库，并对数据库进行操作和维护。 1.2 基本功能 1.3 gsql使用必备技能 GaussDB基于PostgreSQL开发，基础功能和PostgreSQL一样，可以优先了解PostgreSQL的操作。 PostgreSQL官网文档：PostgreSQL: Documentation: 17: PostgreSQL 17.5 Documentation。 1.4 下载客户端 新GaussDB(DWS)集群版本为 8.2.13，对应的gsql版本为 8.2。 下载方式 1： 登录公有云控制台，进入DWS产品页面下载。根据操作系统版本选择下载链接，本文档使用系统为64位CentOS 7。 链接：https://obs.myhuaweicloud.com/dws/download/dws_client_8.2.x_redhat_x64.zip 
下载方式 2： 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客户端主机章节。 2.1 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存放在bin目录中。 
执行以下命令配置客户端： source gsql_env.sh 
使用 `--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。 需要先执行： source gsql_env.sh 问题二： gsql: could not connect to server: Operation now in progress 
`telnet ip port` 查看端口连通性。 
网络不通，需开通网络策略。 
END
gsql简介
连接数据库 通过gsql客户端远程连接GaussDB(DWS)数据库。 执行SQL语句 支持交互式地键入并执行SQL语句，也可以执行一个文件中指定的SQL语句。 执行元命令 元命令可以帮助管理员查看数据库对象的信息、查询缓存区信息、格式化SQL输出结果，以及连接到新的数据库等。元命令的详细说明请参见元命令参考。
gsql部署和使用
2.2 gsql使用
常见问题