Version guide and downloads

Version guide

The SDK encapsulates API operations for Java, such as data processing and search. For other features, use the control SDK.

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

Compatibility

• Version 3.1.3 of the SDK is significantly different from version 2.1.x. You cannot use SDK 2.1.x to access Standard Edition applications.

• SDK 3.1.3 and later support Premium Edition and Standard Edition applications.

• Multi-application queries are supported.

• The scroll method in version 3.1.3 does not support sort.

Update log

V4.0.0 (2021-09-13)

• Added the `ReSearch::DISABLE` parameter for drop-down suggestions.

• Corrected the URI for drop-down suggestions.

V3.9.0 (2021-08-10)

• Added an overloaded `DocumentClient.push` method to support passing JSONArray documents.

V3.8.0 (2021-08-02)

• Added the `com.aliyun.opensearch.tracer.ClientTracer` interface for request monitoring.

V3.7.0 (2021-05-11)

• Deprecated V3 control API requests.

V3.6.0 (2020-09-23)

• Added support for the FinalDistinct clause.

• Added support for custom query clauses.

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

• Added support for Security Token Service (STS).

• Added the `Rank.secondRankType` search parameter (EXPRESSION|CAVA_SCRIPT).

• Added the `userId` and `reSearch` (HOMONYM) parameters for drop-down suggestions.

• Added the `SuggestParams` class and the `execute` method for drop-down suggestions.

• Fixed a bug where the parameter for the number of drop-down suggestions was invalid.

• Corrected the value of the `reSearch` parameter for drop-down suggestions from HOMONY to HOMONYM.

v3.5.0 (2020-04-14)

• Added support for STS.

• Added the `Rank.secondRankType` search parameter (EXPRESSION|CAVA_SCRIPT).

• Added the `userId` and `reSearch` (HOMONY) parameters for drop-down suggestions.

• Added the `SuggestParams` class and the `execute` method for drop-down suggestions.

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

• Added support for HTTPS.

V3.4.0 (2019-08-23)

• Added support for HTTPS.

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

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

Update description

v3.2.0 Java SDK (2018-06-07)

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

New features

• The Scroll method supports sorting by a single integer field.

• AppClient supports the `switchTo` method for batch version switching.

• Added support for multi-application search.

• You can retrieve or update quotas based on an application name or ID.

• Added support for modifying application quotas in the new billing model, including billing specifications, storage capacity, and compute resources.

• Added support for new drop-down suggestions.

Bug fixes

• Fixed an issue where connections were not returned to the connection pool if a request was not closed after it received a GZIP stream response. This could cause the connection pool to fill up and the SDK to hang.

v3.1.3 Java SDK (2017-04-14)

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

• Moved third-party dependencies into the OpenSearch package to reduce dependency conflicts with user applications. All dependencies, except for the slf4j-api component, are relocated to this package.

• Added support for FULLJSON.

• Cleared documents from the buffer after a commit, regardless of success or failure. This reduces ambiguity when using the SDK API.

Downloads

Latest stable version

V4.0.0 Java SDK (2021-09-13) (Recommended)

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

Previous versions

V3.2.0 Java SDK (2018-06-07)

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

V3.1.3 Java SDK (2017-04)

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