1、支持操作系统
Windows 7 及以上 64 位系统 Linux 内核 2.6 及以上系统 Mac 操作系统(macOS)
2、环境要求
环境 | 要求 |
- 硬盘:10G 及以上 | |
- OpenJRE 8 及以上版本 |
3、安装步骤
在首次建立连接或软件中的所有连接都被删除后,软件启动后会自动弹出新建连接向导,引导大家建立连接。
在创建新连接窗口,选择 KaiwuDB 驱动,单击下一步。 在常规页签,设置主机、端口、数据库、用户和密码。 (可选)勾选显示非缺省的数据库,显示所有数据库。默认情况下,只显示指定连接的数据库。 (可选)单击测试链接,检查连接是否成功。连接成功后,将显示以下信息: 单击确定,数据库导航区将自动更新,显示已连接的数据库。
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 | 是 | 是 |
CHAR | 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 的服务进程发送消息,访问任何形式的表格数据,操作流程如下:
连接数据源并创建到数据库的连接。
创建查询或更新指令。
为数据库传递查询和更新指令。
处理数据库响应并返回的结果。
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>
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 的高效管理 。