JavaSDK（查询/推送）

提供Java语言对API接口的封装（数据处理、搜索等），其他功能请使用管控SDK。

<dependency>
    <groupId>com.aliyun.opensearch</groupId>
    <artifactId>aliyun-sdk-opensearch</artifactId>
    <version>6.2.1</version>
</dependency>

• 3.1.3与2.1.x SDK版本差别较大，不支持通过2.1.x版本SDK访问标准版应用；

• 3.1.3及以上SDK版本，支持高级版和标准版应用；

• 支持多应用查询；

• 3.1.3版scroll方法不支持sort；

V6.2.1(2025-07-22)

升级org.josn依赖版本至20250517

V6.2.0(2025-02-21)

新增支持chat查询

V6.1.0(2024-08-16)

新增支持BearerToken访问

V6.0.1(2024-01-18)

• 解决响应状态码为4XX或5XX时可能出现的Socket Closed错误

• 允许在构建OpenSearchClient时传入HttpClientManager实例

V6.0.0(2023-11-20)

• 新增支持Credential Provider SDK

• 允许在请求后获取到原始的HttpResponse对象

• 支持SSE

V5.1.0(2023-09-15)

新增非GET方法支持Query String传参及认证

V5.0.0(2022-12-02)

OpenSearchClient不再共享同一个HttpClientManager实例

增加DocumentClient.push重载方法支持传入JSONArray文档

新增com.aliyun.opensearch.tracer.ClientTracer请求监控接口

废弃V3管控API请求

• 支持FinalDistinct子句

• 支持自定义查询子句

• 支持临时安全令牌（STS）；

• 新增搜索参数Rank.secondRankType（EXPRESSION|CAVA_SCRIPT）；

• 新增下拉提示参数userId和reSearch（HOMONYM）

• 新增SuggestParams与下拉提示的execute方法；

• 修复下拉提示条数参数无效的错误；

• 修复下拉提示reSearch参数值（HOMONY => HOMONYM）

• 支持临时安全令牌（STS）

• 新增搜索参数Rank.secondRankType（EXPRESSION|CAVA_SCRIPT）

• 新增下拉提示参数userId和reSearch（HOMONY）

• 新增SuggestParams与下拉提示的execute方法

• 支持数据采集 2.0；

• 支持HTTPS；

• 修复abtest 传参问题

• 数据采集 2.0

• 支持HTTPS

• 支持 A/B Test

• 支持行为数据采集

• Maven地址

  <dependency>
    <groupId>com.aliyun.opensearch</groupId>
    <artifactId>aliyun-sdk-opensearch</artifactId>
    <version>3.3.0</version>
  </dependency>

• 新功能

  支持 A/B Test

  支持 行为数据采集

• Maven地址

  <dependency>
    <groupId>com.aliyun.opensearch</groupId>
    <artifactId>aliyun-sdk-opensearch</artifactId>
    <version>3.2.0</version>
  </dependency>

• 支持下拉提示

• 新功能

  • Scroll方法支持sort（仅限单个int类型字段）。

  • AppClient支持switchTo切换版本，用于批量切换版本。

  • 支持多应用搜索。

  • 根据应用名或应用ID，获取或更新配额。

  • 支持修改新计费模型应用配额（包括计费规格、存储容量、计算资源）。

  • 支持新下拉提示。

• 修复Bug

  在使用完request后需要进行关闭，因为如果response是gzip流，不进行关闭，连接不会归还到连接池，会导致连接池满整个SDK hang住。

• Maven地址

  <dependency>
    <groupId>com.aliyun.opensearch</groupId>
    <artifactId>aliyun-sdk-opensearch</artifactId>
    <version>3.1.3</version>
  </dependency>

• 将第三方依赖放入opensearch的包中。为了减少与用户的依赖冲突，除了slf4j-api组件，其他依赖全部relocated到opensearch的package下。

• FULLJSON支持。

• commit时无论成功还是失败，都清掉buff里的doc，减少上sdk API使用上的歧义。

• suggest（下拉提示）功能确认相关组件已上线，SDK的功能已可开放使用。