使用命令行访问MogDB

本文档介绍如何使用命令行访问MogDB。gsql是MogDB提供的在命令行下运行的数据库连接工具。此工具除了具备操作数据库的基本功能，还提供了若干高级特性，便于用户使用。

确认连接信息

客户端工具通过数据库主节点连接数据库。因此连接前，需获取数据库主节点所在服务器的IP地址及数据库主节点的端口号信息。

操作步骤

1. 以操作系统用户omm登录数据库主节点。

2. 使用"gs_om -t status --detail"命令查询MogDB各实例情况。

   gs_om -t status --detail
   复制

   [  Datanode State   ]
   node                 node_ip         instance                state
   ---------------------------------------------------------------------------------
   1  mogdb-kernel-0005 172.16.0.176    6001 /mogdb/data/db1 P Primary Normal
   复制

   如上部署了数据库主节点实例的服务器IP地址为172.16.0.176。数据库主节点数据路径为"/mogdb/data/db1"。

3. 确认数据库主节点的端口号。

   在步骤2查到的数据库主节点数据路径下的postgresql.conf文件中查看端口号信息。示例如下:

   cat /mogdb/data/db1/postgresql.conf | grep port
   复制

   port = 26000    # (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
   复制

   第一行中的26000为数据库主节点的端口号。

前提条件

已安装MogDB，并确认连接信息。

连接数据库

1. 以操作系统用户omm登录数据库主节点。

2. 连接数据库。

   数据库安装完成后，默认生成名称为postgres的数据库。第一次连接数据库时可以连接到此数据库。

   执行如下命令连接数据库。

   gsql -d postgres -p 26000
   复制

   其中postgres为需要连接的数据库名称，26000为数据库主节点的端口号。请根据实际情况替换。

   连接成功后，系统显示类似如下信息:

   gsql ((MogDB 2.0.1 build f892ccb7) compiled at 2021-07-09 16:12:59 commit 0 last mr  )
   Non-SSL connection (SSL connection is recommended when requiring high-security)
   Type "help" for help.
   postgres=#
   复制

   omm用户是管理员用户，因此系统显示"postgres=#"。若使用普通用户身份登录和连接数据库，系统显示"postgres=>"。

   "Non-SSL connection"表示未使用SSL方式连接数据库。如果需要高安全性时，请使用SSL连接。

3. 退出数据库。

   postgres=# \q
   复制