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

Note Tablestore SDK for Java V4.0.0 and later versions support max versions and time to live (TTL) and are not compatible with Tablestore SDK for Java V2.x.x.

Version: 5.7.0

Release date: April 7, 2020

Download URL: 5.7.0

Change records:
  • ParallelScan is supported for search indexes. For more information, see ParallelScan.
  • TableStoreWrite 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 or deleted for 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: GroupBy and aggregation operations can be performed on data when search indexes are used.

Version: 5.1.0

Release date: July 1, 2019

Download URL: 5.1.0

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

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.x is compatible with Tablestore SDK for Java V4.x.
  • ExistQuery is added for queries based on search indexes.

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:
  • Log4j2 and log4j2.xml are removed.
  • TunnelWorker: The automatic retry logic in poor network conditions is improved.

Version: 4.7.4

Release date: September 27, 2018

Download URL:

Change records:
  • The following features are added for search indexes:
    • BoolQuery
    • RangeQuery
    • WildcardQuery
    • NestedQuery
    • Tokenization
    • Sorting
  • Global secondary indexes are 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:

  • The conditional update feature is added.
  • The filter feature is added.

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 request sending to receiving are provided. 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.

The incompatibilities between Tablestore SDK for Java V2.1.0 and V2.0.4 are as follows:

  • 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: