JDBC 驱动

clickzetta-jdbc

clickzetta-jdbc

是只包含 JDBC 能力的轻量 SDK，适合通过标准 JDBC API、连接池、ORM 或 BI 工具连接 Lakehouse。如果还需要

ClickZettaClient

ClickZettaClient

、实时写入或 Bulkload，请使用包含 JDBC 模块的完整 SDK

clickzetta-java

clickzetta-java

。

Maven artifact	包含能力	适用场景
`clickzetta-jdbc` clickzetta-jdbc	JDBC 驱动	只执行 SQL、使用连接池或集成 JDBC 工具；依赖更少、包体更轻量，推荐 JDBC-only 应用使用
`clickzetta-java` clickzetta-java	JDBC、 `ClickZettaClient` ClickZettaClient 、Realtime、Bulkload	同一应用还需要实时写入、批量写入或统一 Client API

💡 提示：

clickzetta-java

clickzetta-java

已包含

clickzetta-jdbc

clickzetta-jdbc

，不要同时引入两个 artifact。只需按功能范围选择其中一个。

Java 环境需求

Clickzetta Lakehouse JDBC 驱动同时提供 Java 8 和 Java 17 两条版本线。Java 8 运行环境使用 3.x 最新稳定版；Java 17 运行环境使用 4.x 最新稳定版。

JDBC 驱动下载

只使用 JDBC 时，在项目的

pom.xml

pom.xml

中添加轻量依赖：

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

如果应用还需要实时写入或 Bulkload，改用完整 SDK：

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

也可以在 Maven 仓库页面按运行环境选择最新稳定版本并直接下载 Jar 包：

配置 JDBC 驱动

要使用 Clickzetta Lakehouse JDBC 驱动连接到 Clickzetta Lakehouse，你需要按照以下步骤进行配置：

JDBC 驱动类

在你的 JDBC 应用程序中，使用

com.clickzetta.client.jdbc.ClickZettaDriver

com.clickzetta.client.jdbc.ClickZettaDriver

类加载驱动。

JDBC 连接字符串

使用 JDBC 驱动连接到 Clickzetta Lakehouse 时，JDBC 连接字符串的语法格式如下：

jdbc:clickzetta://<instance_name>.<region_id>.api.clickzetta.com/<workspace_name>?<connection_params>

连接参数说明：
- ```
<instance_name>
```
  <instance_name>
  ：Lakehouse 服务实例名称。在开通指定 Region 的 Lakehouse 服务实例时，系统会自动分配实例名称。你可以在 Clickzetta 产品控制台页面找到 Lakehouse 实例名称。
  
  预览
- ```
<region_id>
```
  <region_id>
  ：服务实例所在的云厂商及区域的代码，如：cn-shanghai-alicloud。所有region_id详见云服务和地域。
- ```
<workspace_name>
```
  <workspace_name>
  ：工作空间名称。
- ```
<connection_params>
```
  <connection_params>
  ：支持使用
```
=
```
  =
  格式定义参数，多个参数之间用
```
&
```
  &
  符号分隔。常用参数如下表所示：

参数	取值
username	Clickzetta登录用户名
password	登录用户密码
schema	指定默认连接的schema，可选
virtualCluster	配置JDBC连接默认使用的虚拟集群，可选。如不选择指定，需要连接后通过SQL命令 `use vcluster <vc_name>` use vcluster <vc_name> 指定方可使用
use_http=true	是否使用 HTTP 协议，默认为 HTTPS。当使用 Private Link 连接时需要指定该参数。

连接串示例

jdbc:clickzetta://lakehouse_instance_name.cn-shanghai-alicloud.api.clickzetta.com/default?username=Alice&password=xxxxx&schema=public&virtualCluster=default

联系我们