使用vsql连接数据库

vsql是Vastbase提供的在命令行下运行的数据库连接工具。此工具除了具备操作数据库的基本功能，还提供了若干高级特性，便于用户使用。本节主要介绍如何使用vsql本地连接数据库，远程连接、密态连接Vastbase的方法请参考《管理员指南》中的使用vsql连接一文。

前提条件

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

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

步骤2 使用vsql连接本地数据库。

vsql -d vastbase -p 5432

步骤3 首次登陆时修改密码。

（管理员首次登录时）如果用户的数据库版本是2.2（Build 5.75）及以上且角色是系统管理员（vbadmin）、安全管理员（vbsso）或者审计管理员（vbaudit），首次登录时系统会强制要求修改口令，修改语法如下：
```
ALTER ROLE 用户名 IDENTIFIED BY '新口令' REPLACE '原随机口令';
```
其中原随机口令表示：
- 实例化数据库安装：安装过程中会生成随机口令作为管理员初始口令，显示信息如下：
- 非实例化数据库安装：vb_initdb初始化数据库时生成的管理员随机口令，显示信息如下：
（普通用户首次登录时）如果您的数据库版本是2.2（Build 5.75）及以上且属于管理员新创建用户或者修改过口令后的普通用户，首次登录数据库，需要自行修改口令后才可以正常操作数据库，修改语法如下：
```
ALTER ROLE 用户名 IDENTIFIED BY '新口令' REPLACE '原口令';
```

步骤4 退出数据库。

\q

执行元命令\q可以退出连接。