openGauss源码解析（19）
openGauss源码解析：第2章 openGauss开发快速入门（9）
2.1.9 安装验证
通过openGauss提供的gs_om工具可以完成数据库状态检查。
1） 前提条件
openGauss数据库已安装。
2） 操作步骤
（1） 以omm用户身份登录服务器。
（2） 执行如下命令检查数据库状态是否正常，“cluster_state”显示“Normal”表示数据库可正常使用。
gs_om -t status
数据库安装完成后，默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。
其中<默认数据库名称>为需要连接的数据库名称，<端口号>为数据库主节点的端口号，即XML配置文件中的dataPortBase的值。请根据实际情况替换。
gsql -d <默认数据库名称> -p <端口号>
连接成功后，系统显示类似如下信息表示数据库连接成功。
gsql ((openGauss x.x.x build 290d125f) compiled at 2021-03-08 02:59:43 commit 2143 last mr 131
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.
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)
# supported by the operating system:
# 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'
# 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'
# %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
