一、学习目标
学习openGauss数据库客户端工具gsql的使用。
二、课程学习
gsql是openGauss提供在命令行下运行的数据库连接工具，可以通过此工具连接服务器并对其进行操作和维护，除了具备操作数据库的基本功能，gsql还提供了若干高级特性，便于用户使用。
三、课程作业：
1.gsql命令连到数据库omm
使用omm用户连接到本机omm数据库的5432端口，命令中的-r选项提供了对gsql命令的历史版本支持。
通过学习测试使用gsql命令两种方式登录guass数据库。-d 指定使用用户 -p 指定端口号
su - omm
gsql -r
或
gsql -d omm -p 5432 -r
2.查看数据库的版本、版权信息
在gsql中查看数据库的版本、pg基础版本和版权信息
select version(); -- guass数据库版本信息
show server_version; -- 使用的pg基础版本
3.常见元命令使用
\l命令，元命令\l的作用是显示openGauss数据库集簇中，目前有哪些数据库。
\conninfo命令，元命令\conninfo的作用是在gsql中，显示会话的连接信息。
\c[onnect] [DBNAME]命令，元命令\ c[onnect] [DBNAME]的作用是在gsql中，切换连接的数据库postgres
\du命令和\dg命令，元命令\dg命令与元命令\du命令的作用类似，都是显示openGauss数据库集簇中，目前有哪些用户和角色。
\\du
\\dg
\db命令，元命令\db的作用是显示openGauss数据库集簇中，目前有哪些表空间。
\\db
\dn命令，元命令\dn的作用是显示当前数据库有哪些数据库模式。\dn
创建表
CREATE TABLE customer\_t
( c\_customer\_sk integer,
c\_customer\_id char(5),
c\_first\_name char(6),
c\_last\_name char(8)
) ;
插入数据
INSERT INTO customer\_t (c\_customer\_sk, c\_customer\_id, c\_first\_name,c\_last\_name) VALUES (3769, 5, 'Grace','White');
\dt命令，命令\dt的作用是显示数据库中所有的表。
\\dt
\d TableName命令，元命令\d TableName的作用是查看某个表的信息。
\\d customer\_t
\di IndexName命令，查看索引信息，元命令\di IndexName的作用是查看某个索引的信息。
create index idx_customer_id on customer_t(c_customer_id);
\\di
可以用\pset命令以不同的方法显示表：
\\pset border 2
SELECT \* FROM customer\_t;
打开扩展表格式模式。
##### \\x
4.使用两种方法，连到postgres数据库中
a、使用 gsql 工具指定postgres 库登录 gsql -d postgres
gsql -d postgres
b、登录默认库omm后，使用\c命令连接到postgres库
gsql -r
/c postgres
5.测试gsql中的默认事务自动提交功能
show AUTOCOMMIT;
测试gsql中事务默认为自动提交功能
create table customer\_new as select \* from customer\_t;
\\q
重新登录后看到之前创建的表customer_new：
gsql -d postgres -p 5432 -r
\\dt
6.测试gsql中的事务手动提交功能
Opengauss默认执行完一条语句后，立即提交。可以关闭自动提交功能：
注意：此处设置ATUOCOMMIT必须用大写！
\\set AUTOCOMMIT off
\\echo :AUTOCMMIT --查看自动提交是否关闭
插入一些数据
INSERT INTO customer\_t (c\_customer\_sk, c\_customer\_id, c\_first\_name,c\_last\_name) VALUES
(6885, 1, 'Joes', 'Hunter'),
(4321, 2, 'Lily','Carter'),
(9527, 3, 'James', 'Cook'),
(9500, 4, 'Lucy', 'Baker');
查看表中数据
select \* from customer\_t;
执行回滚
ROLLBACK;
检查是否回滚成功
SELECT \* FROM customer\_t;
查看gsql中事务是否默认为自动提交
测试gsql手动提交
测试后回滚成功。
7.了解gsql相关帮助
连接数据库时，可以使用如下命令获取帮助信息。
gsql --help
\h获取和SQL语法有关的帮助信息
\\h
\? 获取和元命令有关的帮助信息
\\？
四、学习心得
gsql是GaussDB提供在命令行下运行的数据库连接工具，基本功能是连接数据库；执行sql语句；执行元命令。在使用gsql时要注意先确认连接信息，以操作系统用户omm登录数据库主节点后连接数据库，一般默认生成名为postgres的数据库（在本次实训环境中默认omm）。我们在操作时候使用元命令更加便利，数据库元命令具有简短方便的特点，尤其是\du，\dg，\dn等。
