This topic describes the version history of Tablestore SDK for Java.

Note Tablestore SDK for Java V4.0.0 and later support max versions and time to live (TTL). Both of these parameters are incompatible with Tablestore SDK for Java V2.x.x.

Version: 5.10.3

Release date: October 26, 2020

Download URL: 5.10.3

Change records:
  • Delivery service is added. For more information about how to use the console or Tablestore SDKs, see Quick start or Use SDKs.
  • Aggregation that queries rows in groups is supported for search index. For more information, see Aggregation.
  • Format check for configuration parameters is added.
  • The SDK is optimized and connected to the computing engine.

Version: 5.7.0

Release date: April 7, 2020

Download URL: 5.7.0

Change records:
  • Parallel scan is supported for search index. For more information, see Parallel scan.
  • TableStoreWriter is optimized for Tablestore SDK for Java.

Version: 5.4.0

Release date: November 18, 2019

Download URL: 5.4.0

Change records:
  • Predefined columns can be added to or deleted from existing tables.
  • Tunnel Service is optimized for Tablestore SDK for Java.

Version: 5.3.0

Release date: September 10, 2019

Download URL: 5.3.0

Change records: Aggregation can be performed on data when search index is used.

Version: 5.1.0

Release date: July 1, 2019

Download URL: 5.1.0

Change records: Additional tokenization methods are supported in search index.

Version: 5.0.0

Release date: June 10, 2019

Download URL: 5.0.0

Change records:
  • To unify SDK version numbers, Tablestore SDK for Java is updated to 5.x. Tablestore SDK for Java V5.x is compatible with Tablestore SDK for Java V4.x.
  • Exists query is added to search index.

Version: 4.12.1

Release date: May 8, 2019

Download URL: 4.12.1

Change records: Timeline model V2 is added.

Version: 4.10.2

Release date: March 11, 2019

Download URL: tablestore-4.10.2

Change records:
  • Remove log4j2 implement and log4j2.xml.
  • TunnelWorker: fix auto retry logic when network condition is too bad.

Version: 4.7.4

Release date: September 27, 2018

Download URL:

Change records:
  • The following features are added to search index:
    • Boolean query
    • Range query
    • Wildcard query
    • Nested query
    • Full-text search
    • Sorting
  • Global secondary index is added.

Version: 4.0.0

Release date: August 1, 2016

Download URL:

Change records:

Version: 2.2.4

Release date: May 12, 2016

Download URL:

Change records:

  • Condition update is added.
  • The filter feature is supported.

Version: 2.1.0

Release date: November 12, 2015

Download URL:

Change records:

  • Asynchronous network transmission and performance tuning: QPS is increased by several times when the CPU utilization is the same.
  • Flexible and easy-to-use asynchronous operations: Callback is introduced and Future is returned simultaneously.
  • Content related to OSS SDK is removed: The new version of Tablestore SDK for Java includes code related only to Tablestore SDK. The directory structure is fine-tuned.
  • Retry logic optimization: The default retry logic is optimized. Retry attempts are allowed for single-row errors in batch operations.
  • Log optimization: Detailed log records from when requests are sent to when requests are received. Log records of slow requests are provided. Trace IDs can be used to view the comprehensive log records of the communications between Tablestore SDK for Java and the backend service.
  • The OTSWriter plug-in is supported to import multiple data: delivers easy-to-use and efficient data import experience.
  • Other improvements: Tools and functions that support a variety of data types are provided. The operation used to calculate data sizes is provided.

Tablestore SDK for Java V2.1.0 and V2.0.4 have the following incompatibilities:

  • The import path for several classes must be modified after the later version of Tablestore SDK for Java is used. Packages of several classes are modified. For example, the package of ClientConfiguration is changed from com.aliyun.openservices to com.aliyun.openservices.ots. These packages are modified because Tablestore SDK is separated from OSS SDK. The classes shared by the both SDKs must also be in the packages of Tablestore.
  • If you no longer use an OTSClient instance in some scenarios, for example, before the program exits, you must call the shutdown method of OTSClient to release all threads and connection resources of the OTSClient instance.
  • Names of some configuration items of ClientConfiguration are adjusted. For example, time units are added to the names.
  • Adjustments are made to dependencies of earlier Tablestore SDK for Java. For example, HttpAsyncClient and Joda-Time are used. If you encounter problems when you run the program, check whether imported dependencies conflict with the existing dependencies.

Version: 2.0.4

Release date: September 25, 2015

Download URL: