VastbaseG100

连接数据库

连接数据库的客户端工具包括vsql、应用程序接口（如ODBC和JDBC）。

• vsql是Vastbase自带的客户端工具。3.2.2使用vsql连接数据库，可以交互式地输入、编辑、执行SQL语句。

• 用户可以使用标准的数据库3.2.3应用程序接口（如ODBC和JDBC），开发基于Vastbase的应用程序。

配置服务端远程连接

进行远程连接前，需要在部署了数据库主节点的机器上设置允许客户端访问数据库，并配置远程连接。

操作步骤

以下步骤需要在Vastbase所在主机上执行。

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

步骤2 配置客户端认证方式，请参考5.1.1配置客户端接入认证。

步骤3 配置listen_addresses，listen_addresses即远程客户端连接使用的数据库主节点ip或者主机名。

1.进入数据库，使用如下SQL命令查看数据库主节点目前的listen_addresses配置。

show listen_addresses;

查询到的信息类似如下：

listen_addresses
------------------
localhost

2.使用如下命令把要添加的IP追加到listen_addresses后面，多个配置项之间用英文逗号分隔。例如，追加IP地址172.16.103.84。

alter system set listen_addresses='localhost,172.16.103.84';

步骤4 执行如下命令重启Vastbase。

vb_ctl stop -D 数据库目录
vb_ctl start -D 数据库目录

使用vsql连接

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

注意事项

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

本地连接数据库

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

步骤2 连接数据库。

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

vsql -d vastbase -p 5432

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

vsql ((Vastbase 2.2.0 build 290d125f) compiled at 2020-05-08 02:59:43 commit 2143 last mr 131 
Non-SSL connection (SSL connection is recommended when requiring high-security) 
Type "help" for help. 
 
vastbase=# 

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

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

步骤3 首次登录需要修改密码。原始密码为安装Vastbase数据库手动输入的密码，具体请参见《安装指南》，此处需将原始密码修改为自定义的密码，例如Mypwd123，命令如下：

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

步骤4 退出数据库。

vastbase=# \q

远程连接数据库

步骤1 完成远程连接配置，操作步骤参见3.2.1配置服务端远程连接。

步骤2 在客户端机器（10.10.0.30）上，连接数据库。

vsql -d vastbase -h 10.10.0.11 -U jack -p 5432 -W Test@123

vastbase为需要连接的数据库名称，10.10.0.11为数据库主节点所在的服务器IP地址，jack为连接数据库的用户，5432为数据库主节点的端口号，Test@123为连接数据库用户jack的密码。

• 连接Vastbase的机器与Vastbase不在同一网段时，-h指定的IP地址应为Manager界面上所设的coo.cooListenIp2（应用访问IP）的取值。
• 禁止使用vastbase用户进行远程连接数据库。

应用程序接口

用户可以使用标准的数据库应用程序接口（如ODBC和JDBC），开发基于Vastbase的应用程序。

支持的应用程序接口

每个应用程序是一个独立的开发项目。应用程序通过API与数据库进行交互，在避免了应用程序直接操作数据库系统的同时，增强了应用程序的可移植性、扩展性和可维护性。表3-1为Vastbase所支持的应用程序接口及其下载地址。

表3-1 数据库应用程序接口

使用JDBC和ODBC接口连接数据库属远程连接，因此需要Vastbase已经做了支持3.2.1配置服务端远程连接。