使用vsql连接数据库

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

前提条件

• 已确认连接信息，包括连接的数据库名称与数据库端口。

• 已确认连接信息，包括连接的IP、数据库名称与数据库端口。

本地连接数据库

步骤1 执行如下命令以操作系统用户vastbase登录数据库主节点，连接成功后即可执行数据库命令对数据库进行管理。

vsql -d vastbase -p 5432

• vastbase：需要连接的数据库名称，安装完成后，默认生成名称为vastbase的数据库名称，实际登录时请根据具体情况替换。

• 5432：数据库主节点的端口号，实际登录时请根据具体情况替换。

• 使用vsql链接数据库时需采用-d和-p指定要连接的数据库及端口号。

步骤2 （管理员首次登录时）如果您的数据库版本是2.2（Build 5.75）及以上且角色是系统管理员（vbadmin）、安全管理员（vbsso）或者审计管理员（vbaudit），首次登录时系统会强制要求修改口令，修改语法如下：

ALTER ROLE 用户名 IDENTIFIED BY '新口令' REPLACE '原随机口令';

原随机口令：

• 实例化数据库安装：安装过程中会生成随机口令作为管理员初始口令，显示信息如下：

  

• 非实例化数据库安装：vb_initdb初始化数据库时生成的管理员随机口令，显示信息如下：

  

步骤3 （普通用户首次登录时）如果您的数据库版本是2.2（Build 5.75）及以上且属于管理员新创建用户或者修改过口令后的普通用户，首次登录数据库，需要自行修改口令后才可以正常操作数据库，修改语法如下：

ALTER ROLE 用户名 IDENTIFIED BY '新口令' REPLACE '原口令';

步骤4 退出数据库。

\q

使用vsql远程连接

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

vsql -d vastbase -p 5432

步骤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 postgres -U user1