更新时间:2025-08-25 GMT+08:00

使用前须知

DataArtsFabric SQL Java软件开发包(DataArtsFabric SQL Java SDK,DataArtsFabric SQL Java Software Development Kit)是DataArtsFabric SQL提供的REST API的Java语言版本的封装。用户可以使用SDK提供的接口方法来使用DataArtsFabric SQL服务,以简化用户在使用中的开发步骤。

本部分介绍JavaSDK的版本变更,并提供SDK的安装说明

变更说明

表1展示了本SDK的版本变更情况,以及某些功能变化的说明。

表1 Java SDK版本变更说明

版本

变更类型

变更说明

2.0.0-r3

SDK首次发布

使用前须知:

  • 使用前请确认您已经开通并有权限使用DataArtsFabric SQL服务,包括DataArtsFabric SQL会涉及的Lakeformation服务和OBS服务等。
  • 请确认您已了解DataArtsFabric SQL中的一些基本概念,如工作空间(Workspace)、工作端点(Endpoint)、访问密钥(AK和SK)、会话(Session)等。

Java SDK方法概览

表2总结了DataArtsFabric SQL Java SDK支持的接口方法及描述,每个接口方法的详细描述和示例代码请单击表中方法名称跳转至详情页查看。

表2 Java SDK方法概述

方法名称

方法

功能描述

创建Session

createSession

创建一个新会话,返回会话ID。

关闭Session

closeSession

关闭指定会话,释放相关资源。

同步执行SQL

syncQuery

执行SQL查询并同步等待结果,返回完整数据集。

异步执行SQL

asyncQuery

提交SQL查询后立即返回任务ID,结果通过异步方式获取。

取消查询

cancelExecute

终止正在执行的异步查询任务。

获取查询结果(通过OBS获取)

getStatementResult

获取异步查询的结果,结果集从OBS中读取。

获取查询结果(直接获取)

getStatementResultDirect

获取异步查询的结果,结果集由服务端直接返回。

兼容性说明

推荐使用的JDK版本:JDK 1.8及以上版本。