Table of Contents
- openGauss学习笔记-05 openGauss gsql连接与使用方法
- 5.1 以操作系统用户omm登录数据库主节点
- 5.2 连接数据库
- 5.3 数据库简单操作
- 5.4 退出数据库
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 ".
[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 ~]$
👍 点赞，你的认可是我创作的动力！
⭐️ 收藏，你的青睐是我努力的方向！
✏️ 评论，你的意见是我进步的财富！
