GaussDB数据库连接方式之gsql工具连接

一、业务场景

本实验是使用gsql登录基于华为云GaussDB实例，进行数据库基本操作，通过gsql命令，在数据库实例中创建库、用户、schema、表等对象。

二、操作时长

本次实验总时长预计40分钟。

三、购买华为云上实例

3.1  登录华为云官网https://www.huaweicloud.com/，进入控制台页面

3.2 进入创建页面

选择对应的区域后（本示例使用华为-上海一，可以根据实际情况修改），再单击左侧菜单

从跳出的页面左侧选择“数据库“，这里会看到数据库类型列表，这里有两种创建方法数据库实例。

方法一：鼠标移动到“云数据库GaussDB”选项上停留时，会有二级窗口出现，直接单击创建。

方法二：单击“云数据库GaussDB”选项

进入云数据库GaussDB列表管理页面，再单击右侧“购买数据库实例”

3.3 创建实例

进入创建数据库步骤页面填写信息。

这里根据实际需要选择计费模式、区域（默认是进入控制台后选择的区域）、产品类型、引擎版本、实例类型和部署形态，以及可用区这些信息

记住这里使用的虚拟私有云和安全组信息，安装gsql时购买ECS时，需要与之保持一致

选择安全组时，除默认组可选外，可以使用“查看安全组”，在新开窗口中新建安全组，再使用本页面中“查看安全组”左侧刷新按钮，选择新建的安全组，下面的企业项目也是一样。

根据实际需要填写完成后，单击“立即购买”，进入参数确认页面，如果填写无误，可提交，开始创建数据库实例。

四、安装gsql

4.1 购买ESC服务器

gsql需要在linux服务器环境执行，所以先购买ECS。与购买数据库示例类似，在控制台左侧菜单中选择计算，在右侧弹出窗口中选择弹性云服务器ECS，单击创建后，会进入购买弹性云服务器详细配置页面。

在配置页面选择计费模式、区域（默认为进入控制台后选中的区域）、硬件规格等，配置选择不一样，所产生的费用单价也不相同，请根据实际需求选择合适的配置。

注意上面选择机型（arm/x86）和操作系统，gsql当前支持Euler和Kylinv10

记住这里使用的虚拟私有云和安全组信息，需要与购买的云数据库保持一致，不然连接数据库需要额外的配置

本示例中是从本地上传gsql包，所以选择开通EIP，实际是可以在ECS上下载gsql包后解压安装，请根据实际需要选择弹性公网配置。

配置服务器名称和密码，本案例配置的root的密码就是服务器上root用户的密码，登录ECS服务器时需要使用。

配置项选择完成后，右侧会有当前所有选择的配置项清单，确认声明后，可以单击立即购买来创建ECS。

创建ECS成功后，从列表中可以看到对应的服务器是运行中，单击左侧名称id，可以进入详细信息页面

如图中红色框所示，为ECS的EIP（公网IP）

4.2  获取驱动包

根据创建的云数据库引擎版本，下载对应的驱动包

4.3 安装gsql工具包

远程登录ECS服务器

在新开的页面中使用cloudshell登录，单击立即登录

检查区域和云服务器信息，输入购买ECS时配置的root用户密码，单击连接，就能连接上ECS服务器。

如果长时间没有跳转，则需要配置安全组策略。

将鼠标移动到“cloudshell代理IP”处，可以从新弹出的窗口中看到代码ip信息。

在ECS信息中，选择安全组，在安全组信息中单击配置规则

在新开的配置安全组页面中，单击添加规则，在新弹出的页面中增加cloudshell代理IP配置。

连接到服务器后，页面显示如下。

上传gsql安装包到环境

直接解压

执行gsql --help，正常出现命令的使用帮助则正常安装gsql完成

五、使用gsql操作GaussDB

5.1 用gsql连接数据库

安装完gsql后，可以使用gsql连接数据库，正常是可以在1.4.3步骤中安装好gsql后直接执行gsql命令连接数据库，本示例是使用内网连接数据库。

在ECS服务器列表中选择本ecs，单击远程登录

在新开的窗口中检查区域和云服务器信息，选择私网

单击跳转后，在新页面输入ECS服务器root的密码

单击连接，则会跳转到ECS服务器命令行窗口页面，如果连接超时，请参考4.3中步骤，修改安全组策略。

从GaussDB详细信息中找到服务器ip地址，注意这里是主备机，只取主节点的ip，如果登录的是备机，将只能查询。

在ECS服务器上执行gsql命令，登录数据库

#gsql -d 目标库名 -h 目标IP地址 -p 端口号 -U 用户 -ar

-d后面的postgres是数据库示例中的数据库名称，新创建的示例中有postgres库

-p后面是数据库示例的端口号，在购买云上数据库时，如果不配置，则默认为8000，如果有修改，则输入对应的值

-U 大写U，后面的root为数据库用户名，是创建数据库示例时配置密码的管理员账号，gsql命令回车后，需要输入配置的密码，或者直接使用-W参数输入密码。

-ar是显示辅助，a表示命令中展示所有信息，r表示可以使用键盘上的上、下键执行历史的sql命令。

gsql登录数据库的参数，请自行参考帮助文档。

5.2 操作数据库

使用gsql操作数据库，以下为示例：

5.2.1 新建数据库

CREATE DATABASE testdb;

5.2.2 创建行存表

CREATE TABLE PART
(
    P_PARTKEY     BIGINT NOT NULL,
	P_NAME        VARCHAR(55) NOT NULL,
	P_MFGR        CHAR(25) NOT NULL,
	P_BRAND       CHAR(10) NOT NULL,
	P_TYPE        VARCHAR(25) NOT NULL,
	P_SIZE        BIGINT NOT NULL,
	P_CONTAINER   CHAR(10) NOT NULL,
	P_RETAILPRICE DECIMAL(15,2) NOT NULL,
	P_COMMENT     VARCHAR(23) NOT NULL
)WITH (ORIENTATION = ROW);

5.2.3 创建用户jim

CREATE USER jim PASSWORD xxxxxx@123';