JDBC驱动

Java环境需求

Clickzetta Lakehouse JDBC驱动需要Java 1.8版本或更高版本。请确保您的开发环境已安装并配置了相应版本的Java。

JDBC驱动下载

您可以通过以下两种方式下载并使用Clickzetta Lakehouse JDBC驱动：

通过Maven依赖在项目的pom.xml文件中添加以下依赖代码：


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

直接下载 SDK Jar包，在maven库页面可以找到对应版本的Jar包并下载。

配置JDBC驱动

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

JDBC驱动类

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

参数	取值
username	Clickzetta登录用户名
password	登录用户密码
schema	指定默认连接的schema，可选
virtualCluster	配置JDBC连接默认使用的虚拟集群，可选。如不选择指定，需要连接后通过SQL命令`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

联系我们