使用指导

前提条件

连接数据库时使用的用户需要具备访问数据库的权限。

背景信息

使用gsql命令可以连接远程数据库服务。连接远程数据库服务时，需要在服务器上设置允许远程连接，详细操作请参见《管理指南》中“日常运维 > gsql客户端连接 > 使用gsql远程连接”章节。

操作步骤

使用gsql连接到MogDB服务器。

gsql工具使用-d参数指定目标数据库名、-U参数指定数据库用户名、-h参数指定主机名、-p参数指定端口号信息。

说明: 若未指定数据库名称，则使用初始化时默认生成的数据库名称；若未指定数据库用户名，则默认使用当前操作系统用户作为数据库用户名；当某个值没有前面的参数（-d、-U等）时，若连接的命令中没有指定数据库名（-d）则该参数会被解释成数据库名；如果已经指定数据库名（-d）而没有指定数据库用户名（-U）时，该参数则会被解释成数据库用户名。

示例1，使用omm用户连接到本机mogdb数据库的15400端口。
```
gsql -d mogdb -p 15400
```
示例2，使用jack用户连接到远程主机mogdb数据库的15400端口。
```
gsql -h 10.180.123.163 -d mogdb -U jack -p 15400
```
示例3，参数mogdb和omm不属于任何选项时，分别被解释成了数据库名和用户名。
```
gsql mogdb omm -p 15400
```
等效于
```
gsql -d mogdb -U omm -p 15400
```
详细的gsql参数请参见命令参考。
执行SQL语句。

以创建数据库human_staff为例。
```
CREATE DATABASE human_staff;
```
通常，输入的命令行在遇到分号的时候结束。如果输入的命令行没有错误，结果就会输出到屏幕上。

执行gsql元命令。

以列出MogDB中所有的数据库和描述信息为例。

MogDB=#  \l
                                List of databases
      Name      |  Owner   | Encoding  | Collate | Ctype |   Access privileges
----------------+----------+-----------+---------+-------+-----------------------
 human_resource | omm | SQL_ASCII | C       | C     |
 postgres       | omm | SQL_ASCII | C       | C     |
 template0      | omm | SQL_ASCII | C       | C     | =c/omm         +
                |          |           |         |       | omm=CTc/omm
 template1      | omm | SQL_ASCII | C       | C     | =c/omm          +
                |          |           |         |       | omm=CTc/omm
 human_staff    | omm | SQL_ASCII | C       | C     |
(5 rows)

更多gsql元命令请参见元命令参考。

示例

首先要创建一个表空间EXAMPLE：

MogDB=# CREATE TABLESPACE EXAMPLE RELATIVE LOCATION 'tablespace1/tablespace_1';
CREATE TABLESPACE

表空间创建成功后，创建schema HR：

MogDB=# CREATE schema HR;
CREATE SCHEMA

以把一个查询分成多行输入为例。注意提示符的变化：

MogDB=# CREATE TABLE HR.areaS(
MogDB(# area_ID   NUMBER,
MogDB(# area_NAME VARCHAR2(25)
MogDB(# )tablespace EXAMPLE;
CREATE TABLE

查看表的定义：

MogDB=# \d HR.areaS
               Table "hr.areas"
  Column   |         Type          | Modifiers
-----------+-----------------------+-----------
 area_id   | numeric               |
 area_name | character varying(25) |
Tablespace: "example"

向HR.areaS表插入四行数据：

MogDB=# INSERT INTO HR.areaS (area_ID, area_NAME) VALUES (1, 'Europe');
INSERT 0 1
MogDB=# INSERT INTO HR.areaS (area_ID, area_NAME) VALUES (2, 'Americas');
INSERT 0 1
MogDB=# INSERT INTO HR.areaS (area_ID, area_NAME) VALUES (3, 'Asia');
INSERT 0 1
MogDB=# INSERT INTO HR.areaS (area_ID, area_NAME) VALUES (4, 'Middle East and Africa');
INSERT 0 1

切换提示符：

MogDB=# \set PROMPT1 '%n@%m %~%R%#'
omm@[local] MogDB=#

查看表：

omm@[local] MogDB=#SELECT * FROM HR.areaS;
 area_id |       area_name
---------+------------------------
       1 | Europe
       4 | Middle East and Africa
       2 | Americas
       3 | Asia
(4 rows)

可以用\pset命令以不同的方法显示表：

omm@[local] MogDB=#\pset border 2
Border style is 2.
omm@[local] MogDB=#SELECT * FROM HR.areaS;
+---------+------------------------+
| area_id |       area_name        |
+---------+------------------------+
|       1 | Europe                 |
|       2 | Americas               |
|       3 | Asia                   |
|       4 | Middle East and Africa |
+---------+------------------------+
(4 rows)
omm@[local] MogDB=#\pset border 0
Border style is 0.
omm@[local] MogDB=#SELECT * FROM HR.areaS;
area_id       area_name
------- ----------------------
      1 Europe
      2 Americas
      3 Asia
      4 Middle East and Africa
(4 rows)

使用元命令：

omm@[local] MogDB=#\a \t \x
Output format is unaligned.
Showing only tuples.
Expanded display is on.
omm@[local] MogDB=#SELECT * FROM HR.areaS;
area_id|2
area_name|Americas

area_id|1
area_name|Europe

area_id|4
area_name|Middle East and Africa

area_id|3
area_name|Asia
omm@[local] MogDB=#