学习目标
学习openGauss数据库客户端工具gsql的使用。
课程学习
gsql是openGauss提供在命令行下运行的数据库连接工具，可以通过此工具连接服务器并对其进行操作和维护，除了具备操作数据库的基本功能，gsql还提供了若干高级特性，便于用户使用。
1.使用gsql命令连接数据库
–使用omm用户连接到本机omm数据库的5432端口，命令中的-r选项提供了对gsql命令的历史版本支持。
su - omm
gsql -r
或
gsql -d omm -p 5432 -r
2.在gsql中查看数据库的版本、pg基础版本和版权信息
select version();
show server_version;
\copyright
3.常见元命令的使用
–\l命令，元命令\l的作用是显示openGauss数据库集簇中，目前有哪些数据库。
\l
–\conninfo命令，元命令\conninfo的作用是在gsql中，显示会话的连接信息。
\conninfo
–\c[onnect] [DBNAME]命令，元命令\ c[onnect] [DBNAME]的作用是在gsql中，切换连接的数据库postgres。
\c postgres
–\du命令和\dg命令，元命令\dg命令与元命令\du命令的作用类似，都是显示openGauss数据库集簇中，目前有哪些用户和角色。
\du
\dg
–\db命令，元命令\db的作用是显示openGauss数据库集簇中，目前有哪些表空间。
\db
–\dn命令，元命令\dn的作用是显示当前数据库有哪些数据库模式。
\du
–创建表
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.gsql中的事务：测试gsql中的默认事务自动提交功能
–查看gsql中事务是否默认为自动提交
show AUTOCOMMIT;
–测试gsql中事务默认为自动提交功能
create table customer_new as select * from customer_t;
\q
–重新登录后看到之前创建的表customer_new：
gsql -d omm -p 5432 -r
\dt
5.gsql中的事务：测试gsql中的事务手动提交功能
–测试gsql手动提交
#Opengauss默认执行完一条语句后，立即提交。可以关闭自动提交功能：
#注意：此处设置ATUOCOMMIT必须用大写！
\set AUTOCOMMIT off
--插入一些数据
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;
6.gsql相关的帮助
–连接数据库时，可以使用如下命令获取帮助信息。
gsql --help
–\h获取和SQL语法有关的帮助信息
\h
–? 获取和元命令有关的帮助信息
\？
课程作业
1.gsql命令连到数据库omm
2.查看数据库的版本、版权信息
3.常见元命令使用
–\l命令，元命令\l的作用是显示openGauss数据库集簇中，目前有哪些数据库。
\l
–\conninfo命令，元命令\conninfo的作用是在gsql中，显示会话的连接信息。
\conninfo
–\c[onnect] [DBNAME]命令，元命令\ c[onnect] [DBNAME]的作用是在gsql中，切换连接的数据库postgres。
\c postgres
–\du命令和\dg命令，元命令\dg命令与元命令\du命令的作用类似，都是显示openGauss数据库集簇中，目前有哪些用户和角色。
\du
\dg
–\db命令，元命令\db的作用是显示openGauss数据库集簇中，目前有哪些表空间。
\db
–\dn命令，元命令\dn的作用是显示当前数据库有哪些数据库模式。
\du
–创建表
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数据库中
方法1：
su - omm
gsql -r
切换连接的数据库到postgres
\c postgres
方法2：
gsql -d postgres -p 5432 -r
5.测试gsql中的默认事务自动提交功能
–查看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中的事务手动提交功能
–测试gsql手动提交
#Opengauss默认执行完一条语句后，立即提交。可以关闭自动提交功能：
#注意：此处设置ATUOCOMMIT必须用大写！
\set AUTOCOMMIT off
--插入一些数据
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;
可以看到，刚才插入的4条数据都没有自定提交，回滚成功。
7.了解gsql相关帮助
- 7.1 通过
gsql --help获取相关帮助
- 7.2 通过
\h获取和SQL语法有关的帮助信息
- 7.3 通过
\?获取和元命令有关的帮助信息
