openGauss数据库源码解析（二）| openGauss开发快速入门（4）

2.2 openGauss基本使用
openGauss安装完成后会自动启动，用户可以使用openGauss自带的gsql（openGauss交互终端）客户端连接数据库进行相关SQL操作。
2.2.1 连接数据库
本节为您介绍如何使用gsql客户端连接数据库。gsql是openGauss自带的客户端工具。使用gsql连接数据库，可以交互式地输入、编辑、执行SQL语句。

1. 确认连接信息
   gsql客户端工具通过数据库主节点连接数据库。因此连接前需获取数据库主节点所在服务器的IP地址及数据库主节点的端口号信息。
   1） 操作步骤
   （1） 以操作系统用户omm登录数据库主节点。
   （2） 使用“gs_om -t status --detail”命令查询openGauss各实例情况。
   gs_om -t status --detail
   查询结果如下。
   [ DBnode State ]
   node node_ip instance state

1 plat1 192.168.0.11 5001 /srv/BigData/gaussdb/data1/dbnode Normal
如上所示，部署了数据库主节点实例的服务器IP地址为192.168.10.11。数据库主节点数据路径“/srv/BigData/gaussdb/data1/dbnode”。
（3） 确认数据库主节点的端口号。
在（2）中查到的数据库主节点数据路径下的conf文件中查看端口号信息。示例如下。
cat /srv/BigData/gaussdb/data1/dbnode/postgresql.conf | grep port
查询结果如下，8000为数据库主节点的端口号。
port = 8000 # (change requires restart)
#comm_sctp_port = 1024 # Assigned by installation (change requires restart)
#comm_control_port = 10001 # Assigned by installation (change requires restart)
1. supported by the operating system:
1. e.g. ‘localhost=10.145.130.2 localport=12211 remotehost=10.145.130.3 remoteport=12212, localhost=10.145.133.2 localport=12213 remotehost=10.145.133.3 remoteport=12214’
1. e.g. ‘localhost=10.145.130.2 localport=12311 remotehost=10.145.130.4 remoteport=12312, localhost=10.145.133.2 localport=12313 remotehost=10.145.133.4 remoteport=12314’
1. %r = remote host and port
alarm_report_interval = 10
support_extended_features=true

2. 使用gsql本地连接
   gsql是openGauss提供的在命令行下运行的数据库连接工具。此工具除了具备操作数据库的基本功能，还提供了若干高级特性，便于用户使用。本节只介绍如何使用gsql本地连接数据库。
   1） 注意事项
   缺省情况下，客户端连接数据库后处于空闲状态时会根据参数“session_timeout”的默认值自动断开连接。如果要关闭超时设置，设置参数“session_timeout”为0即可。
   2） 前提条件
   已确认连接信息，获取数据库主节点端口号信息。
   3） 操作步骤
   （1） 以操作系统用户omm登录数据库主节点。
   （2） 连接数据库。第一次连接数据库时可以连接到安装后默认生成的数据库。执行如下命令连接数据库。
   gsql -d -p
   连接成功后，系统显示类似如下信息。
   gsql ((openGauss 1.0.0 build 290d125f) compiled at 2020-05-08 02:59:43 commit 2143 last mr 131
   Non-SSL connection (SSL connection is recommended when requiring high-security)
   Type “help” for help.
   openGauss=#
   omm用户是管理员用户，因此系统显示“openGauss=#”。若使用普通用户身份登录和连接数据库，系统显示“openGauss=>”。
   “Non-SSL connection”表示未使用SSL方式连接数据库。如果需要高安全性时，请使用SSL连接。
   （3） 首次登录需要修改密码。原始密码为安装openGauss数据库时手动输入的密码，此处需将原始密码修改为自定义的密码，例如Mypwd123，命令如下。
   openGauss=# ALTER ROLE omm IDENTIFIED BY ‘Mypwd123’ REPLACE ‘XuanYuan@2012’;
   （4） 退出数据库。
   openGauss=# \q
   2.2.2 使用数据库
   本节描述使用数据库的基本操作。通过此节用户可以完成创建数据库、创建表及向表中插入数据和查询表中数据等数据管理和基础权限管理操作。
3. 从这里开始
   本节为您完整地介绍一个使用数据库的示例，帮助您更好了解数据库，更多关于SQL语句的使用请参见后续章节。
   （1） 以操作系统用户omm登录数据库主节点。
   （2） 执行如下命令连接数据库。
   gsql -d -p
   当结果显示为如下信息，则表示连接成功。
   gsql ((openGauss 1.0.0 build 290d125f) compiled at 2020-05-08 02:59:43 commit 2143 last mr 131）
   Non-SSL connection (SSL connection is recommended when requiring high-security)
   Type “help” for help.
   openGauss=#
   （3） 创建数据库用户。
   默认只有openGauss安装时创建的管理员用户可以访问初始数据库，您还可以创建其他数据库用户账号访问数据库。
   openGauss=# CREATE USER joe WITH PASSWORD “Bigdata@123”;
   当结果显示为如下信息，则表示创建成功。
   CREATE ROLE
   如上创建了一个用户名为joe，密码为Bigdata@123的用户。
   （4） 创建数据库。
   openGauss=# CREATE DATABASE db_tpcc OWNER joe;
   当结果显示为如下信息，则表示创建成功。
   CREATE DATABASE
   db_tpcc数据库创建完成后，就可以按如下方法退出数据库，使用新用户joe连接db_tpcc数据库执行创建表等操作。您也可以选择继续在默认数据库下进行后续的体验。
   openGauss=# \q
   gsql -d db_tpcc -p 8000 -U joe -W Bigdata@123
   gsql ((openGauss 1.0.0 build 290d125f) compiled at 2020-05-08 02:59:43 commit 2143 last mr 131)
   Non-SSL connection (SSL connection is recommended when requiring high-security)
   Type “help” for help.
   db_tpcc=>
   （5） 创建schema。
   db_tpcc=> CREATE SCHEMA joe AUTHORIZATION joe;
   当结果显示为如下信息，则表示创建schema成功。
   CREATE SCHEMA
   （6） 创建表。
   创建一个名称为mytable，只有一列的表。字段名为firstcol，字段类型为integer。
   db_tpcc=> CREATE TABLE mytable (firstcol int);
   当结果显示为如下信息，则表示表创建成功。
   CREATE TABLE
   向表中插入数据。
   db_tpcc=> INSERT INTO mytable values (100);
   当结果显示为如下信息，则表示插入数据成功。
   INSERT 0 1
   查看表中数据。
   db_tpcc=> SELECT * FROM mytable;
   firstcol

100