连接数据库
本文档假设用户已经安装 KaiwuDB 开发者中心。
首次建立连接或软件中的所有连接都被删除后,软件启动后会自动弹出新建连接向导,引导用户建立连接。

其他情况下,如需创建连接,可以选择以下任一操作:
单击工具栏或数据库导航区工具栏中的新建连接按钮。
在菜单栏中,单击数据库,然后从下拉菜单中选择新建连接。
新建连接
以下步骤以首次建立连接为例,说明如何连接数据库。
在创建新连接窗口,选择 KaiwuDB 驱动,然后单击下一步。
在常规页签,设置主机、端口、数据库、用户和密码(如果采用非安全部署模式,则无需设置密码)。
(可选)单击测试链接,检查连接是否成功。连接成功后,系统将通过弹窗显示用户口令到期时间、许可证到期时间、测点等信息。
单击完成。
SSH 登录
如需使用 SSH 连接数据库,遵循以下步骤。
单击工具栏或数据库导航区工具栏中的新建连接按钮,或者在菜单栏中单击数据库 > 新建连接。
在创建新连接窗口,选择 KaiwuDB 驱动,然后单击下一步。
在常规页签,填写要连接的数据库名称,用户名及密码。主机和端口使用系统默认值。
在 SSH 页签,勾选使用 SSH 通道,设置主机地址、端口、用户名和密码。
(可选)单击测试链接,检查连接是否成功。连接成功后,系统将通过弹窗显示用户口令到期时间、许可证到期时间、测点等信息。
单击完成。
Proxy 设置
如需使用 Proxy 连接数据库,遵循以下步骤。
单击工具栏或数据库导航区工具栏中的新建连接按钮,或者在菜单栏中单击数据库 > 新建连接。
在创建新连接窗口,选择 KaiwuDB 驱动,然后单击下一步。
在常规页签,填写数据库名称、用户名及密码。主机和端口使用系统默认值。
在 Proxy 页签,勾选使用 SOCKS 代理,设置主机地址、端口、用户名和密码。
(可选)单击测试链接,检查连接是否成功。连接成功后,系统将通过弹窗显示用户口令到期时间、许可证到期时间、测点等信息。
单击完成。
SSL 登录
前提条件
如需使用 TLS 安全证书连接数据库,需满足以下条件:
- 已经获取
ca.crt
和client.<user>.crt
文件。 - 已经使用 OpenSSL 命令将
client.<user>.key
文件转换为.pk8
格式。
说明
启用 TLS 安全模式安装部署 KaiwuDB 时,系统会自动生成 ca.crt
和 client.<user>.crt
文件。文件的存储目录是 /etc/kwdb/certs/
。
步骤
如需使用 SSL 连接数据库,遵循以下步骤。
单击工具栏或数据库导航区工具栏中的新建连接按钮,或者在菜单栏中单击数据库 > 新建连接。
在创建新连接窗口,选择 KaiwuDB 驱动,然后单击下一步。
在常规页签,填写主机地址、端口号、数据库名称、用户名及密码。
提示
KaiwuDB 默认支持用户使用证书或密钥连接数据库,如果选择使用证书连接数据库,可不填写密码。KaiwuDB 支持用户通过
server.host_based_authentication.configuration
集群参数设置用户连接数据库时的身份鉴别方式,更多信息,参见身份鉴别。在 SSL 页签,勾选使用 SSL,添加根证书、SSL 证书和 SSL 证书密钥。
提示
在默认身份鉴别设置下,如果选择使用密码连接数据库,可不勾选使用证书验证以及添加证书。
(可选)单击测试链接,检查连接是否成功。连接成功后,系统将通过弹窗显示用户口令到期时间、许可证到期时间、测点等信息。
单击完成。
TLCP 登录
前提条件
如需使用 TLCP 安全证书连接数据库,需已经获取根证书、加密证书、加密证书密钥、签名证书和签名证书密钥。
说明
启动 TLCP 安全模式安装部署 KaiwuDB 时,系统会自动生成根证书、加密证书、加密证书密钥、签名证书和签名证书密钥文件。文件的存储目录是 /etc/kwdb/certs/
。
步骤
如需使用 TLCP 连接数据库,遵循以下步骤。
单击工具栏或数据库导航区工具栏中的新建连接按钮,或者在菜单栏中单击数据库 > 新建连接。
在创建新连接窗口,选择 KaiwuDB 驱动,然后单击下一步。
在常规页签,填写主机地址、端口号、数据库名称、用户名及密码。
提示
KaiwuDB 默认支持用户使用证书或密钥连接数据库,如果选择使用证书连接数据库,可不填写密码。KaiwuDB 支持用户通过
server.host_based_authentication.configuration
集群参数设置用户连接数据库时的身份鉴别方式,更多信息,参见身份鉴别。在 TLCP 页签,勾选使用 TLCP 和使用证书验证。
提示
在默认身份鉴别设置下,如果选择使用密码连接数据库,可不勾选使用证书验证以及添加证书。
- 在证书部分,添加根证书、加密证书、加密证书密钥、签名证书、签名证书密钥。
- 在高级部分,选择 TLCP 版本和 TLCP 验证模式。
(可选)单击测试链接,检查连接是否成功。连接成功后,系统将通过弹窗显示用户口令到期时间、许可证到期时间、测点等信息。
单击完成。