搜索

免费试用

加载中~

《一文讲透》第2期：两种 KWDB 的快速上手连接方式

KaiwuDB 社区官方号 time

2024-09-19

上一期我们详细讲述了如何通过单点逻辑和容器部署两种方式，快速完成 KWDB 的安装部署。今天，我们也将分享两种方式来实现 KWDB 的快速连接访问：

低阶，零基础代码小白首选：

使用 KaiwuDB 开发者中心连接 KWDB

进阶，适合具备基础代码的开发者伙伴：

使用 KaiwuDB JDBC 连接 KWDB

使用 KaiwuDB JDBC 连接 KWDB

KaiwuDB Developer Center（KaiwuDB 开发者中心）是专门为 KWDB 数据库系统量身定制的可视化管理工具，我们改变了传统命令行操作方式，为大家提供了可视化的数据库操作平台，即使你是数据库“小白”，也能轻松驾驭我们

KaiwuDB 开发者中心包括数据库连接、数据库管理、模式管理、表管理等多个功能模块，几乎涵盖了数据库的所有相关操作。接下来将为大家详细介绍如何使用 KaiwuDB 开发者中心可视化工具连接 KWDB 数据库。

一、安装 KaiwuDB 开发者中心

1、支持操作系统

KaiwuDB 开发者中心支持以下操作系统：

Windows 7 及以上 64 位系统
Linux 内核 2.6 及以上系统
Mac 操作系统（macOS）

Tip：不同操作系统版本的界面略有差异，但功能完全相同。

2、环境要求

KaiwuDB 开发者中心的安装需满足以下环境要求：

环境	要求
硬件环境	- 内存：1G 及以上- 硬盘：10G 及以上
软件环境	- KWDB 2.0 及以上版本- OpenJRE 8 及以上版本

3、安装步骤

解压缩安装包（下载地址：https://gitee.com/kwdb/kwdb/releases），文件目录如下：

双击运行 KaiwuDB Developer Center.exe 应用程序，即可完成安装。

二、连接 KWDB 数据库

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

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

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

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

接下来，我们以首次建立连接为例，具体说明如何连接数据库：

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

在常规页签，设置主机、端口、数据库、用户和密码。

（可选）勾选显示非缺省的数据库，显示所有数据库。默认情况下，只显示指定连接的数据库。
（可选）单击测试链接，检查连接是否成功。连接成功后，将显示以下信息：
单击确定，数据库导航区将自动更新，显示已连接的数据库。

使用 KaiwuDB JDBC 连接 KWDB

Java 数据库连接（Java Database Connectivity，JDBC）是 Java 应用程序访问数据库的标准 API。它提供一套完整的接口，允许 Java 应用程序与不同类型的数据库进行交互。KWDB 提供了 JDBC 驱动程序 KaiwuDB JDBC，支持 Java 应用程序与 KWDB 数据库交互，执行查询、插入、更新和删除等操作。

JDBC 驱动程序在将 Java 数据类型发送到数据库之前，会将其转换为相应的 JDBC 类型。有关 Java 数据类型和 JDBC 数据类型对比转换的详细信息，见下表：

SQL	JDBC	关系引擎支持	时序引擎支持
BIT	java.lang.Boolean	是	否
BOOL	java.lang.Boolean	是	是
TIMESTAMP	java.sql.Timestamp	是	是
DATE	java.sql.Date	是	否
TIME	java.sql.Time	是	否
NUMERIC	Java.math.BigDecimal	是	否
INTEGER	java.lang.Integer	是	是
BIGINT	java.lang.Long	是	是
FLOAT	java.lang.Float	是	是
DOUBLE	java.lang.Double	是	是
SMALLINT	java.lang.Short	是	是
TINYINT	java.lang.Byte	是	否
REAL	java.lang.Float	是	是
BYTES	[B	是	是
VARBYTES	[B	是	是
ｃｈａｒ	java.lang.String	是	是
NCHAR	java.lang.String	是	是
VARCHAR	java.lang.String	是	是
NVARCHAR	java.lang.String	是	是
ARRAY	java.sql.Array	是	否
BLOB	java.sql.Blob	是	否
CLOB	java.sql.Clob	否	否

KaiwuDB JDBC 是 KWDB 的官方 Java 语言连接器。它基于 PgJDBC 扩展实现，符合 JDBC 4.0、JDBC 4.1 和 JDBC 4.2 规范。Java 开发人员可以使用 KaiwuDB JDBC 驱动程序向 KWDB 的服务进程发送消息，访问任何形式的表格数据，操作流程如下：

连接数据源并创建到数据库的连接。
创建查询或更新指令。
为数据库传递查询和更新指令。
处理数据库响应并返回的结果。

一、安装 KaiwuDB JDBC

1、前提条件

安装 Java（1.8 及以上版本）>>https://docs.oracle.com/en/java/javase/22/install/overview-jdk-installation.html
安装 Maven（3.6 及以上版本）>>https://maven.apache.org/install.html
安装 KWDB 数据库、配置数据库认证方式、创建数据库
获取 KaiwuDB JDBC 驱动包>>https://gitee.com/kwdb/kwdb/releases

2、安装步骤

运行以下命令，将 KaiwuDB JDBC 安装到本地 Maven 仓库中。

mvn install:install-file "-Dfile=../kaiwudb-jdbc.2.0.4.jar" "-DgroupId=com.kaiwudb" "-DartifactId=kaiwudb-jdbc" "-Dversion=2.0.4" "-Dpackaging=jar"

在 pom.xml 中添加依赖，将 KaiwuDB JDBC 引入到 Java 应用程序中。

<dependency><groupId>com.kaiwudb</groupId><artifactId>kaiwudb-jdbc</artifactId><version>2.0.4</version></dependency>

二、连接 KWDB 数据库

用户需要编写 Java 程序代码，连接数据库。Java 程序代码需要包含以下内容：

Driver：通常由数据库厂家提供，处理与数据库服务器的通信。使用 KWDB 前必须先加载 KWDB 数据库驱动程序类，加载方式如下：
```
Class.forName("com.kaiwudb.Driver");
```
数据库连接接口：通过 DriverManager.getConnection() 方法与 KWDB 数据库建立连接。KWDB 支持的连接方式如下：

Connection conn = DriverManager.getConnection(url)
Connection conn = DriverManager.getConnection(url, props)
Connection conn = DriverManager.getConnection(url, user, password)

代码示例

public Connection getConnection() throws Exception{  Class.forName("com.kaiwudb.Driver");  Connection conn = DriverManager.getConnection("jdbc:kaiwudb://127.0.0.1:26257/defaultdb?user=kwdbuser&password=123");return conn;}

以上就是本期的连接教程，记得关注，下一期将和大家分享如何实现 KWDB 的高效管理