openGauss学习笔记-05 openGauss gsql连接与使用方法
openGauss提供了在命令行下运行的数据库连接工具gsql。此工具除了具备操作数据库的基本功能，还提供了若干高级特性，便于用户使用。本节主要介绍如何使用gsql本地连接数据库。您需要提供数据库的名称以及数据库主节点的端口号。
5.1 以操作系统用户omm登录数据库主节点
[root@superman-21 ~]# su - omm
上一次登录： 二 3月 21 07:10:45 CST 2023 pts/0 上
Welcome to 5.10.0-60.18.0.50.oe2203.x86_64
System information as of time: 2023年 03月 21日 星期二 20:01:54 CST
System load: 0.75
Processes: 158
Memory used: 7.4%
Swap used: 0%
Usage On: 12%
IP address: 192.168.1.21
IP address: 192.168.122.1
Users online: 1
To run a command as administrator(user "root"),use "sudo <command>".
[omm@superman-21 ~]$
5.2 连接数据库
数据库安装完成后，默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。
执行如下命令连接数据库。
$ gsql -d postgres -p 5432
其中postgres为需要连接的数据库名称，5432为数据库主节点的端口号。请根据实际情况替换。
连接成功后，系统显示类似如下信息：
[omm@superman-21 ~]$ gsql -d postgres -p 5432
gsql ((openGauss 3.1.1 build 70980198) compiled at 2023-01-06 09:27:09 commit 0 last mr )
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.
openGauss=#
omm用户是管理员用户，因此系统显示“DBNAME=#”。若使用普通用户身份登录和连接数据库，系统显示“DBNAME=>”。提示符告诉您openGauss准备为您输入SQL语句。
“Non-SSL connection”表示未使用SSL方式连接数据库。
5.3 数据库简单操作
-
首次登录建议修改密码以提高安全性。
命令如下：
openGauss=# ALTER ROLE omm IDENTIFIED BY 'XXXXXXXX' REPLACE 'XXXXXXXX';
- 最少包含8个字符；
- 不能和用户名和当前密码相同，或和当前密码反序；
- 至少包含大写字母（A-Z），小写字母（a-z），数字，非字母数字字符（限定为~!@#$%^&*()-_=+|[{}];:,<.>/?）四类字符中的三类字符；
- 安装过程中会生成ssl证书，证书存放路径为{gaussdbAppPath}/share/sslcert/om，其中{gaussdbAppPath}为集群openGauss配置文件中指定的程序安装目录。
- gsql提供了高级功能方便您使用数据库。
gsql程序有一些不属于SQL命令的元命令。它们以反斜线开头，“\”。例如：
-
您可以用下面的命令查询openGauss的版本和版权信息。
openGauss=# \copyright示例命令如下：
openGauss=# \copyright GaussDB Kernel Database Management System Copyright (c) Huawei Technologies Co., Ltd. 2018. All rights reserved. openGauss=# -
您可以用下面的命令获取各种openGauss的SQL命令的帮助语法。
openGauss=# \h示例命令如下：
openGauss=# \h Available help: ABORT CREATE DATA SOURCE DROP OPERATOR ALTER APP WORKLOAD GROUP CREATE DATABASE DROP OWNED ALTER APP WORKLOAD GROUP MAPPING CREATE DIRECTORY DROP PACKAGE ALTER AUDIT POLICY CREATE EXTENSION DROP PACKAGE BODY ALTER DATA SOURCE CREATE FOREIGN TABLE DROP PROCEDURE ALTER DATABASE CREATE FUNCTION DROP PUBLICATION ALTER DEFAULT PRIVILEGES CREATE GROUP DROP RESOURCE LABEL ALTER DIRECTORY CREATE INDEX DROP RESOURCE POOL ALTER EXTENSION CREATE LANGUAGE DROP ROLE ALTER FOREIGN TABLE CREATE MASKING POLICY DROP ROW LEVEL SECURITY POLICY ALTER FOREIGN TABLE FOR HDFS CREATE MATERIALIZED VIEW DROP SCHEMA ALTER FUNCTION CREATE MODEL DROP SEQUENCE ALTER GLOBAL CONFIGURATION CREATE NODE DROP SERVER ALTER GROUP CREATE NODE GROUP DROP SUBSCRIPTION ALTER INDEX CREATE OPERATOR DROP SYNONYM ALTER LARGE OBJECT CREATE PACKAGE DROP TABLE ALTER MASKING POLICY CREATE PACKAGE BODY DROP TABLESPACE ALTER MATERIALIZED VIEW CREATE PROCEDURE DROP TEXT SEARCH CONFIGURATION ALTER NODE CREATE PUBLICATION DROP TEXT SEARCH DICTIONARY ALTER NODE GROUP CREATE RESOURCE LABEL DROP TRIGGER ALTER OPERATOR CREATE RESOURCE POOL DROP TYPE ALTER PACKAGE CREATE ROLE DROP USER ALTER PROCEDURE CREATE ROW LEVEL SECURITY POLICY DROP VIEW ALTER PUBLICATION CREATE SCHEMA DROP WEAK PASSWORD DICTIONARY ALTER RESOURCE LABEL CREATE SEQUENCE DROP WORKLOAD GROUP ALTER RESOURCE POOL CREATE SERVER END ALTER ROLE CREATE SNAPSHOT AS EXECUTE ALTER ROW LEVEL SECURITY POLICY CREATE SNAPSHOT FROM EXECUTE DIRECT ALTER SCHEMA CREATE SUBSCRIPTION EXPLAIN ALTER SEQUENCE CREATE SYNONYM FETCH ALTER SERVER CREATE TABLE GRANT ALTER SESSION CREATE TABLE AS INSERT ALTER SUBSCRIPTION CREATE TABLE PARTITION LOCK ALTER SYNONYM CREATE TABLE SUBPARTITION MERGE ALTER SYSTEM KILL SESSION CREATE TABLESPACE MOVE ALTER SYSTEM SET CREATE TEXT SEARCH CONFIGURATION PREDICT BY ALTER TABLE CREATE TEXT SEARCH DICTIONARY PREPARE ALTER TABLE PARTITION CREATE TRIGGER PREPARE TRANSACTION ALTER TABLE SUBPARTITION CREATE TYPE PUBLISH SNAPSHOT ALTER TABLESPACE CREATE USER PURGE ALTER TEXT SEARCH CONFIGURATION CREATE VIEW PURGE SNAPSHOT ALTER TEXT SEARCH DICTIONARY CREATE WEAK PASSWORD DICTIONARY REASSIGN OWNED ALTER TRIGGER CREATE WORKLOAD GROUP REFRESH MATERIALIZED VIEW ALTER TYPE CURSOR REINDEX ALTER USER DEALLOCATE REPLACE ALTER VIEW DECLARE RESET ALTER WORKLOAD GROUP DELETE REVOKE ANALYSE DO ROLLBACK ANALYZE DROP APP WORKLOAD GROUP ROLLBACK PREPARED ANONYMOUS BLOCK DROP APP WORKLOAD GROUP MAPPING SAMPLE SNAPSHOT ARCHIVE SNAPSHOT DROP AUDIT POLICY SAVEPOINT BEGIN DROP CLIENT MASTER KEY SELECT CALL DROP COLUMN ENCRYPTION KEY SELECT INTO CHECKPOINT DROP DATA SOURCE SET CLEAN CONNECTION DROP DATABASE SET CONSTRAINTS CLOSE DROP DIRECTORY SET ROLE CLUSTER DROP EXTENSION SET SESSION AUTHORIZATION COMMENT DROP FOREIGN TABLE SET TRANSACTION COMMIT DROP FUNCTION SHOW COMMIT PREPARED DROP GLOBAL CONFIGURATION START TRANSACTION COPY DROP GROUP TIMECAPSULE TABLE CREATE APP WORKLOAD GROUP DROP INDEX TRUNCATE CREATE APP WORKLOAD GROUP MAPPING DROP MASKING POLICY UPDATE CREATE AUDIT POLICY DROP MATERIALIZED VIEW VACUUM CREATE BARRIER DROP MODEL VALUES CREATE CLIENT MASTER KEY DROP NODE CREATE COLUMN ENCRYPTION KEY DROP NODE GROUP openGauss=# -
您可以用下面的命令查询openGauss中所有的数据和描述信息。
openGauss=# \l示例命令如下：
openGauss=# \l List of databases Name | Owner | Encoding | Collate | Ctype | Access privileges -----------+-------+----------+-------------+-------------+------------------- finance | omm | UTF8 | en_US.UTF-8 | en_US.UTF-8 | postgres | omm | UTF8 | en_US.UTF-8 | en_US.UTF-8 | school | omm | UTF8 | en_US.UTF-8 | en_US.UTF-8 | template0 | omm | UTF8 | en_US.UTF-8 | en_US.UTF-8 | =c/omm + | | | | | omm=CTc/omm template1 | omm | UTF8 | en_US.UTF-8 | en_US.UTF-8 | =c/omm + | | | | | omm=CTc/omm (5 rows) openGauss=#
5.4 退出数据库
openGauss=# \q
缺省情况下，客户端连接数据库后处于空闲状态时间超过参数session_timeout的默认值（10min）时会自动断开连接。
示例命令如下：
openGauss=# \q
[omm@superman-21 ~]$
👍 点赞，你的认可是我创作的动力！
⭐️ 收藏，你的青睐是我努力的方向！
✏️ 评论，你的意见是我进步的财富！
