The SDK of version 4.0.0 and later provides TTL and Max Versions, and is therefore incompatible with the SDK in Version 2.x.x.

SDK version: 4.10.2

Release date: 2019-03-11


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

SDK version: 4.7.4

Release date: 2018-09-27


  • Added SearchIndex:
    • Multi-Field Search
    • Range query
    • Wildcard search
    • Nested query
    • Full-text search
    • Ranking
  • Added global secondary index.

SDK version: 4.1.0

Release date: 11/10/2016


Updates: The split points of partitions can be get from reponse of DescribeTable.

SDK version: 4.0.0

Release date: 01/08/2016



SDK version: 2.2.4

Release date: 12/05/2016



  • Adds API condition update.

  • Adds filter.

SDK version 2.1.0

Release date: 12/11/2015



  • Asynchronous network transmission and performance tuning: When the CPU usage is the same, the QPS is increased by several times.

  • Flexible and easy-to-use asynchronous interfaces: Callback is introduced and Future is returned simultaneously.

  • Unbundled from OSS SDK: The new version only includes code of TableStore SDK. The directory is slightly adjusted.

  • Optimized retry logic: The default retry logic is optimized. An erroneous single row can be retried independently during batch operations. The retry logic custom method is clearer.

  • Optimized log: Logs are recorded for each step from request sending to request receiving. Logs of slow requests are recorded. Logs of the whole chain from SDK to back-end services are recorded using TraceId.

  • OTSWriter interface supporting batch data importing: This interface aims at providing easy-to-use and efficient data importing service for users.

  • Other optimized functions: Toolbox functions for various data classes are enriched and interfaces for data size computing are provided.


Version 2.1.0 may be slightly incompatible with Version 2.0.4 due to the following limitations:

  • When an old SDK is replaced with the new one, you must change the import paths of a few classes, because the packages of these data classes are adjusted. For example, the package of “ClientConfiguration” is changed from “com.aliyun.openservices” to “com.aliyun.openservices.ots”. The main reason why the package is adjusted is that Table Store SDK is unbundled from OSS SDK. It is therefore more appropriate to put the classes of data commonly used into the package of Table Store.

  • When you no longer use an OTSClient instance (for example, before the program ends), call the shutdown method of OTSClient to release the thread and connection resources occupied by the OTSClient object.

  • Names of some configuration items in “ClientConfiguration” are adjusted. For example, a time unit is added as a configuration item.

  • The dependency between packages in the new SDK is changed. For example, “HttpAsyncClient” and “Jodatime” are used. If any problem occurs during SDK running, check whether a conflicting dependency is introduced.

SDK version 2.0.4

Release date: 25/09/2015