使用vsql连接

vsql是Vastbase提供的在命令行下运行的数据库连接工具。此工具除了具备操作数据库的基本功能，还提供了若干高级特性，便于用户使用。本节只介绍如何使用vsql连接数据库，关于vsql使用方法的更多信息请参考：vsql。

使用vsql本地连接数据库
使用vsql远程连接数据库
使用vsql连接密态数据库

注意事项

缺省情况下，客户端连接数据库后处于空闲状态时会根据参数session_timeout的默认值自动断开连接。如果要关闭超时设置，设置参数session_timeout为0即可。

前提条件

已确认连接信息。

本地连接数据库

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

2、连接数据库。

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

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

vsql -d vastbase -p 5432

其中vastbase为需要连接的数据库名称，5432为数据库主节点的端口号。请根据实际情况替换。另外，也可以使用如下命令连接数据库。

vsql -d "host=127.0.0.1 port=5432 dbname=vastbase user=vastbase password=Admin@123"

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

vsql ((Vastbase x.x.x build 50dc16a6) compiled at 2020-11-29 05:49:21 commit 1071 last mr 1373)
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.

vastbase=#

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

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

3、首次登录建议修改密码。命令如下：

ALTER ROLE vastbase IDENTIFIED BY 'Mypwd123' REPLACE 'XuanYuan@2012';

最少包含8个字符；

不能和用户名和当前密码相同，或和当前密码反序。

至少包含大写字母（A-Z），小写字母（a-z），数字，非字母数字字符（限定为~!@#$%^&*()-_=+|[{}];:,<.>/?）四类字符中的三类字符。

安装过程中会生成ssl证书，证书存放路径为/home/vastbase/local/vastbase/share/sslcert/om。

4、退出数据库。

\q

远程连接数据库

步骤1 以操作系统用户vastbase登录数据库实例所在主机。

步骤2 在数据目录中的pg_hba.conf文件内添加相应的认证策略，详情可参考配置客户端接入认证方式。

local DATABASE USER METHOD [OPTIONS]
host DATABASE USER ADDRESS METHOD [OPTIONS]
hostssl DATABASE USER ADDRESS METHOD [OPTIONS]
hostnossl DATABASE USER ADDRESS METHOD [OPTIONS]

“pg_hba.conf”文件中的每条记录可以是以上四种格式之一，因为认证时系统是为每个连接请求顺序检查”pg_hba.conf”里的记录的，所以这些记录的顺序是非常关键。

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

vsql -h <IP地址> -p <端口号> -d <数据库名> -U <用户名>

示例：

vsql -h 192.168.1.7 -p 5432 -d vastbase -U user1

vastbase：需要连接的数据库名称，安装完成后，默认生成名称为vastbase的数据库，实际登录时请根据具体情况替换。
5432：数据库主节点的端口号，实际登录时请根据具体情况替换。
192.168.1.7：需要远程连接的数据库所在主机的IP地址。实际登录时请根据具体情况替换。
user1：指定连接数据库的用户。实际登录时请根据具体情况替换。

密态数据库连接操作