连接数据库

本文档假设用户已经安装 KaiwuDB 开发者中心。

首次建立连接或软件中的所有连接都被删除后，软件启动后会自动弹出新建连接向导，引导用户建立连接。

其他情况下，如需创建连接，可以选择以下任一操作：

• 单击工具栏或数据库导航区工具栏中的新建连接按钮。

  

• 在菜单栏中，单击数据库，然后从下拉菜单中选择新建连接。

  

新建连接

常规连接

以下步骤以首次建立连接为例，说明如何连接数据库。

1. 在创建新连接窗口，选择 KaiwuDB 驱动，然后单击下一步。

   

2. 在常规页签，设置主机、端口、数据库信息。根据需要选择数据库认证方式（默认为数据库原生认证方式），然后完成对应的用户、密码（如果采用非安全模式，则无需设置密码）等设置。

   • 数据库原生认证：

     

   • KaiwuDB Kerberos 认证

     

3. （可选）单击测试链接，检查连接是否成功。连接成功后，系统将通过弹窗显示用户口令到期时间、许可证到期时间、测点等信息。

   

4. 单击完成。

SSH 登录

如需使用 SSH 连接数据库，遵循以下步骤。

1. 单击工具栏或数据库导航区工具栏中的新建连接按钮，或者在菜单栏中单击数据库 > 新建连接。

2. 在创建新连接窗口，选择 KaiwuDB 驱动，然后单击下一步。

   

3. 在常规页签，根据需要选择数据库认证方式，填写要连接的数据库名称，用户名及密码。主机和端口使用系统默认值。

   

4. 在 SSH 页签，勾选使用 SSH 通道，设置主机地址、端口、用户名和密码。

   

5. （可选）单击测试链接，检查连接是否成功。连接成功后，系统将通过弹窗显示用户口令到期时间、许可证到期时间、测点等信息。

   

6. 单击完成。

Proxy 设置

如需使用 Proxy 连接数据库，遵循以下步骤。

1. 单击工具栏或数据库导航区工具栏中的新建连接按钮，或者在菜单栏中单击数据库 > 新建连接。

2. 在创建新连接窗口，选择 KaiwuDB 驱动，然后单击下一步。

   

3. 在常规页签，设置主机、端口、数据库信息。根据需要选择数据库认证方式（默认为数据库原生认证方式），然后完成对应的用户、密码等设置。

   

4. 在 Proxy 页签，勾选使用 SOCKS 代理，设置主机地址、端口、用户名和密码。

   

5. （可选）单击测试链接，检查连接是否成功。连接成功后，系统将通过弹窗显示用户口令到期时间、许可证到期时间、测点等信息。

   

6. 单击完成。

SSL 登录

前提条件

如需使用 TLS 安全证书连接数据库，需满足以下条件：

• 已经获取 ca.crt和 client.<user>.crt 文件。
• 已经使用 OpenSSL 命令将 client.<user>.key 文件转换为 .pk8 格式。

说明

启用 TLS 安全模式安装部署 KaiwuDB 时，系统会自动生成 ca.crt 和 client.<user>.crt 文件。文件的存储目录是 /etc/kwdb/certs/。

步骤

如需使用 SSL 连接数据库，遵循以下步骤。

1. 单击工具栏或数据库导航区工具栏中的新建连接按钮，或者在菜单栏中单击数据库 > 新建连接。

2. 在创建新连接窗口，选择 KaiwuDB 驱动，然后单击下一步。

   

3. 在常规页签，填写要连接的数据库名称，用户名及密码。主机和端口使用系统默认值。

   提示

   KaiwuDB 默认支持用户使用证书或密钥连接数据库，如果选择使用证书连接数据库，可不填写密码。KaiwuDB 支持用户通过 server.host_based_authentication.configuration 集群参数设置用户连接数据库时的身份鉴别方式，更多信息，参见身份鉴别。

   

4. 在 SSL 页签，勾选使用 SSL，添加根证书、SSL 证书和 SSL 证书密钥。

   提示

   在默认身份鉴别设置下，如果选择使用密码连接数据库，可不勾选使用证书验证以及添加证书。

   

5. （可选）单击测试链接，检查连接是否成功。连接成功后，系统将通过弹窗显示用户口令到期时间、许可证到期时间、测点等信息。

   

6. 单击完成。

TLCP 登录

前提条件

如需使用 TLCP 安全证书连接数据库，需已经获取根证书、加密证书、加密证书密钥、签名证书和签名证书密钥。

说明

启用 TLCP 安全模式安装部署 KaiwuDB 时，系统会自动生成根证书、加密证书、加密证书密钥、签名证书和签名证书密钥文件。文件的存储目录是 /etc/kwdb/certs/。

步骤

如需使用 TLCP 连接数据库，遵循以下步骤。

1. 单击工具栏或数据库导航区工具栏中的新建连接按钮，或者在菜单栏中单击数据库 > 新建连接。

2. 在创建新连接窗口，选择 KaiwuDB 驱动，然后单击下一步。

   

3. 在常规页签，填写主机地址、端口号、数据库名称、用户名及密码。

   提示

   KaiwuDB 默认支持用户使用证书或密钥连接数据库，如果选择使用证书连接数据库，可不填写密码。KaiwuDB 支持用户通过 server.host_based_authentication.configuration 集群参数设置用户连接数据库时的身份鉴别方式，更多信息，参见身份鉴别。

   

4. 在 TLCP 页签，勾选使用 TLCP 和使用证书验证。

   提示

   在默认身份鉴别设置下，如果选择使用密码连接数据库，可不勾选使用证书验证以及添加证书。

   • 在证书部分，添加根证书、加密证书、加密证书密钥、签名证书、签名证书密钥。
   • 在高级部分，选择 TLCP 版本和 TLCP 验证模式。
   

5. （可选）单击测试链接，检查连接是否成功。连接成功后，系统将通过弹窗显示用户口令到期时间、许可证到期时间、测点等信息。

   

6. 单击完成。

复制连接

KaiwuDB 开发者中心支持通过复制粘贴已有连接的方式快速创建数据库连接。

如需复制和粘贴已有数据库连接，遵循以下步骤。

1. 在数据库导航区中，右键点击需要复制的数据库连接，选择复制。

   

2. 右键点击数据库导航区的空白区域，选择粘贴。

   

   系统将自动在导航区创建一个新的数据库连接，连接名称为"原连接名称 1"。