# 使用前须知
DataArts Fabric SQL Java软件开发包（DataArts Fabric SQL Java SDK，DataArts Fabric SQL Java Software Development Kit）是DataArts Fabric SQL提供的REST API的Java语言版本的封装。用户可以使用SDK提供的接口方法来使用DataArts Fabric SQL服务，以简化用户在使用中的开发步骤。
本部分介绍JavaSDK的版本变更，并提供SDK的安装说明
#### 变更说明
[表1]展示了本SDK的版本变更情况，以及某些功能变化的说明。
 表1Java SDK版本变更说明 
| 版本       | 变更类型    | 变更说明 |
|:---|:---|:---|
| 2.0.0-r3 | SDK首次发布 | 无    |
   
**使用前须知：**
- 使用前请确认您已经开通并有权限使用DataArts Fabric SQL服务，包括DataArts Fabric SQL会涉及的Lakeformation服务和OBS服务等。
- 请确认您已了解DataArts Fabric SQL中的一些基本概念，如工作空间（Workspace）、工作端点（Endpoint）、访问密钥（AK和SK）、会话（Session）等。
 
#### Java SDK方法概览
[表2]总结了DataArts Fabric SQL Java SDK支持的接口方法及描述，每个接口方法的详细描述和示例代码请单击表中方法名称跳转至详情页查看。
 表2Java SDK方法概述 
| 方法名称                                                                                                                                             | 方法                       | 功能描述                         |
|:---|:---|:---|
| [创建Session](https://support.huaweicloud.com/devg-fabric/dataartsfabric_sql_04_0069.html#ZH-CN_TOPIC_0000002449670368__section20578165519121)     | createSession            | 创建一个新会话，返回会话ID。              |
| [关闭Session](https://support.huaweicloud.com/devg-fabric/dataartsfabric_sql_04_0069.html#ZH-CN_TOPIC_0000002449670368__section823511493136)       | closeSession             | 关闭指定会话，释放相关资源。               |
| [同步执行SQL](https://support.huaweicloud.com/devg-fabric/dataartsfabric_sql_04_0069.html#ZH-CN_TOPIC_0000002449670368__section74669161278)          | syncQuery                | 执行SQL查询并同步等待结果，返回完整数据集。      |
| [异步执行SQL](https://support.huaweicloud.com/devg-fabric/dataartsfabric_sql_04_0069.html#ZH-CN_TOPIC_0000002449670368__section635925601614)         | asyncQuery               | 提交SQL查询后立即返回任务ID，结果通过异步方式获取。 |
| [取消查询](https://support.huaweicloud.com/devg-fabric/dataartsfabric_sql_04_0069.html#ZH-CN_TOPIC_0000002449670368__section89222249180)             | cancelExecute            | 终止正在执行的异步查询任务。               |
| [获取查询结果(通过OBS获取)](https://support.huaweicloud.com/devg-fabric/dataartsfabric_sql_04_0069.html#ZH-CN_TOPIC_0000002449670368__section14644611271)  | getStatementResult       | 获取异步查询的结果，结果集从OBS中读取。        |
| [获取查询结果(直接获取)](https://support.huaweicloud.com/devg-fabric/dataartsfabric_sql_04_0069.html#ZH-CN_TOPIC_0000002449670368__section182201339124213) | getStatementResultDirect | 获取异步查询的结果，结果集由服务端直接返回。       |
   
#### 兼容性说明
推荐使用的JDK版本：JDK 1.8及以上版本。