JavaSDK（查詢/推送） - OpenSearch

本文將為您詳細介紹OpenSearch-行業演算法版中Java SDK各版本的說明與相關下載。

版本說明

提供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執行個體

V4.0.0(2021-09-13)

增加下拉提示參數ReSearch::DISABLE
更正下拉提示URI

V3.9.0(2021-08-10)

增加DocumentClient.push重載方法支援傳入JSONArray文檔

V3.8.0(2021-08-02)

新增com.aliyun.opensearch.tracer.ClientTracer請求監控介面

V3.7.0(2021-05-11)

廢棄V3管控API請求

V3.6.0( 2020-09-23)

支援FinalDistinct子句
支援自訂查詢子句

v3.5.1 Java SDK(2020-04-24)

支援臨時安全性權杖（STS）；
新增搜尋參數Rank.secondRankType（EXPRESSION|CAVA_SCRIPT）；
新增下拉提示參數userId和reSearch（HOMONYM）
新增SuggestParams與下拉提示的execute方法；
修複下拉提示條數參數無效的錯誤；
修複下拉提示reSearch參數值（HOMONY => HOMONYM）

v3.5.0(2020-04-14)

支援臨時安全性權杖（STS）
新增搜尋參數Rank.secondRankType（EXPRESSION|CAVA_SCRIPT）
新增下拉提示參數userId和reSearch（HOMONY）
新增SuggestParams與下拉提示的execute方法

v3.4.1 Java SDK(2019-09-17)

支援資料擷取 2.0；
支援HTTPS；
修複abtest 傳參問題

V3.4.0(2019-08-23)

資料擷取 2.0
支援HTTPS

v3.3.0 Java SDK(2018-09-03)

支援 A/B Test
支援行為資料擷取

Maven地址

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

新功能
支援 A/B Test
支援行為資料擷取

v3.2.0 Java SDK（2018-06-07）

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住。

v3.1.3 Java SDK（2017-04-14）

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的功能已可開放使用。