Java SDK 简介

云器 Lakehouse 提供两个 Java artifact：轻量的

clickzetta-jdbc

clickzetta-jdbc

只提供 JDBC，完整的

clickzetta-java

clickzetta-java

在 JDBC 基础上增加

ClickZettaClient

ClickZettaClient

、Realtime 和 Bulkload。只执行 SQL 时优先选择

clickzetta-jdbc

clickzetta-jdbc

；需要数据写入 SDK 时选择

clickzetta-java

clickzetta-java

。

功能范围

能力	类或接口	适用场景
JDBC 驱动	`com.clickzetta.client.jdbc.ClickZettaDriver` com.clickzetta.client.jdbc.ClickZettaDriver	SQL 查询、DML、Java 框架或 BI 工具集成
客户端	`com.clickzetta.client.ClickZettaClient` com.clickzetta.client.ClickZettaClient	统一管理连接，并创建 JDBC、RealtimeStream、BulkloadStreamV2
实时写入	`com.clickzetta.client.RealtimeStream` com.clickzetta.client.RealtimeStream	高频小批量写入、事件流、CDC 数据写入
批量写入	`com.clickzetta.client.BulkloadStreamV2` com.clickzetta.client.BulkloadStreamV2	大批量历史数据导入、文件解析后写入 Lakehouse

选择 Maven 依赖

Maven artifact	包含能力	推荐场景
`clickzetta-jdbc` clickzetta-jdbc	JDBC 驱动	只使用标准 JDBC、连接池、ORM 或 BI 工具；依赖更少、包体更轻量
`clickzetta-java` clickzetta-java	JDBC、 `ClickZettaClient` ClickZettaClient 、Realtime、Bulkload	同一应用需要查询和 SDK 写入能力

💡 提示：

clickzetta-java

clickzetta-java

已包含

clickzetta-jdbc

clickzetta-jdbc

，不要在同一项目中重复引入两个 artifact。

只使用 JDBC 时添加：

<dependency> <groupId>com.clickzetta</groupId> <artifactId>clickzetta-jdbc</artifactId> <version>${clickzetta-jdbc.version}</version> </dependency>

需要完整 Java SDK 时添加：

<dependency> <groupId>com.clickzetta</groupId> <artifactId>clickzetta-java</artifactId> <version>${clickzetta-java.version}</version> </dependency>

两个 artifact 使用相同的 Java 版本线。最新补丁版本请以 Maven 仓库为准。

运行环境	版本线	编译版本	当前推荐版本
Java 8	3.x	Java 8	`3.0.29` 3.0.29
Java 17	4.x	Java 17	`4.0.0` 4.0.0

你可以在 Maven 仓库查看所有已发布版本：

Java 版本

```
clickzetta-java
```
clickzetta-java
同时提供 Java 8 和 Java 17 两条版本线：3.x 版本使用 Java 8 编译，适合 Java 8 运行环境；4.x 版本使用 Java 17 编译，适合 Java 17 运行环境。
如果在 Java 9 及以上运行环境中使用 3.x 版本，遇到直接内存或
```
java.nio
```
java.nio
访问限制，需要在 JVM 启动参数中添加：

--add-opens=java.base/java.nio=ALL-UNNAMED

连接信息

Java SDK 和 JDBC 驱动使用同一套连接信息：

参数	说明
`service` service	Lakehouse 服务地址，格式通常为 `<region_id>.api.clickzetta.com` <region_id>.api.clickzetta.com
`instance` instance	Lakehouse 服务实例名称
`workspace` workspace	工作空间名称
`schema` schema	默认 SCHEMA
`vcluster` vcluster	默认计算集群
`username` username	登录用户名
`password` password	登录密码

你可以在 Lakehouse Studio 的 管理 -> 工作空间 页面查看 JDBC 连接串，并从中获取

instance

instance

、

service

service

、

workspace

workspace

等信息。

常见问题

Java 11 连接时报

SSLHandshakeException

SSLHandshakeException

如果错误信息包含

PKIX path building failed

PKIX path building failed

，可能是较旧 Java 11 版本的 TLSv1.3 实现问题。建议升级到更新的生产版本；如果暂时无法升级，可以临时添加 JVM 参数：

-Djdk.tls.client.protocols=TLSv1.2

clickzetta-jdbc

clickzetta-jdbc

和

clickzetta-java

clickzetta-java

如何选择

只使用 JDBC 时安装

clickzetta-jdbc

clickzetta-jdbc

，可以减少不需要的依赖和包体积。需要

ClickZettaClient

ClickZettaClient

、

RealtimeStream

RealtimeStream

或 Bulkload 时安装

clickzetta-java

clickzetta-java

；它已经包含 JDBC 模块，不需要再安装

clickzetta-jdbc

clickzetta-jdbc

。

批量写入使用哪个接口

批量写入使用 Bulkload，支持显式提交流程、分区写入和多种写入操作。

Java SDK 简介

功能范围

选择 Maven 依赖

Java 版本

连接信息

常见问题

Java 11 连接时报
`SSLHandshakeException`
SSLHandshakeException

`clickzetta-jdbc`
clickzetta-jdbc
和
`clickzetta-java`
clickzetta-java
如何选择

批量写入使用哪个接口

相关文档

Java SDK 简介

功能范围

选择 Maven 依赖

Java 版本

连接信息

常见问题

Java 11 连接时报 SSLHandshakeExceptionSSLHandshakeException

clickzetta-jdbcclickzetta-jdbc 和 clickzetta-javaclickzetta-java 如何选择

批量写入使用哪个接口

相关文档

Java 11 连接时报
`SSLHandshakeException`
SSLHandshakeException

`clickzetta-jdbc`
clickzetta-jdbc
和
`clickzetta-java`
clickzetta-java
如何选择