前提条件
连接数据库时使用的用户需要具备访问数据库的权限。
gsql须与数据库版本配套。
背景信息
使用gsql命令可以连接本机的数据库服务，也可以连接远程数据库服务。连接远程数据库服务时，需要在服务器上设置允许远程连接，详细操作请参见《开发者指南》中“数据库使用入门 > 连接数据库 > 使用gsql连接 > 远程连接数据库”章节。
操作步骤
使用gsql连接到GaussDB服务器。
gsql工具使用-d参数指定目标数据库名、-U参数指定数据库用户名、-h参数指定主机名、-p参数指定端口号信息。
若未指定数据库名称，则使用初始化时默认生成的数据库名称；若未指定数据库用户名，则默认使用当前操作系统用户作为数据库用户名；当某个值没有前面的参数（-d、-U等）时，若连接的命令中没有指定数据库名（-d）则该参数会被解释成数据库名；如果已经指定数据库名（-d）而没有指定数据库用户名（-U）时，该参数则会被解释成数据库用户名。
示例1，使用omm用户连接到本机gaussdb数据库的8000端口。
gsql -d gaussdb -p 8000
示例2，使用jack用户连接到远程主机gaussdb数据库的8000端口。
gsql -h 10.180.123.163 -d gaussdb -U jack -p 8000
集中式数据库实例中，连接主DataNode时可以把DataNode的IP地址使用逗号分割全部添加到-h后，gsql将依次从前往后连接每个IP地址，查询当前DataNode是否为主DataNode，如果不是则断开连接尝试下一个IP地址，直到找到主DataNode为止。
gsql -h 10.180.123.163,10.180.123.164,10.180.123.165 -d gaussdb -U jack -p 8000
示例3，参数gaussdb和omm不属于任何选项时，分别被解释成了数据库名和用户名。
gsql gaussdb omm -p 8000
等效于
gsql -d gaussdb -U omm -p 8000
详细的gsql参数请参见命令参考。
执行SQL语句。
以创建数据库human_staff为例。
CREATE DATABASE human_staff;
CREATE DATABASE
通常，输入的命令行在遇到分号的时候结束。如果输入的命令行没有错误，结果就会输出到屏幕上。
执行gsql元命令。
以列出GaussDB中所有的数据库和描述信息为例。
gaussdb=# \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元命令请参见元命令参考。
