This topic describes the version history of the Tablestore SDK for Java.
SDKs of version 4.0.0 and later support max versions and time to live (TTL). These versions are not compatible with SDKs in the 2.x.x series.
Version: 5.17.7
Release date: 2025-11-06
Download link: 5.17.7
Updates:
Added support for the Global Tables feature.
Search indexes now support the FLATTENED type.
Search indexes now support throttling by tag.
Version: 5.17.6
Release date: 2025-05-06
Download link: 5.17.6
Updates:
The vector field type now supports the bytes format.
Search indexes now support the IP data type.
Search indexes now support the JSON data type.
Translate the Chinese comments into English.
Updated the Protobuf version to 4.28.2.
Version: 5.17.5
Release date: 2025-01-13
Download link: 5.17.5
Updates:
The synchronization status is no longer returned when you view a search index.
Optimized the `readMaxTimesPerRound` logic of TunnelClient.
AISearch in search indexes now supports the `minScore` and `numCandidates` parameters.
Added the `trackTotalCount` parameter to search indexes.
Search indexes now support the post-query filtering feature.
Added access denied details to permission-related exceptions.
TunnelClient now supports authentication using CredentialsProvider.
Version: 5.17.4
Release date: 2024-09-04
Download link: 5.17.4
Updates: Added the `updateFullRow` parameter to the TableOptions of tables.
Version: 5.17.2
Release date: 2024-06-21
Download link: 5.17.2
Updates:
Added a case-sensitivity option for tokenization.
The measurement name of a time series table in the Time Series Model can be empty.
Version: 5.17.1
Release date: 2024-05-29
Download link: 5.17.1
Updates:
Time series models now support custom time series identifiers and data fields as primary keys.
Added support for Lastpoint index for time series models.
Search indexes now support the k-nearest neighbor (KNN) vector query feature. For more information, see AISearch.
Version: 5.16.3
Release date: 2023-09-07
Download link: 5.16.3
Updates:
Added support for deleting an analytical store.
Added support for DNS caching and background refresh.
Version: 5.16.1
Release date: 2023-08-17
Download link: 5.16.1
Updates:
Added support for V4 signatures for identity authentication.
Added the TableStoreReader class to support multiple concurrent data queries. For more information, see Read data.
Search indexes now support date histogram statistics. For more information, see Aggregation.
Optimized the internal SDK.
Version: 5.16.0
Release date: 2023-07-28
Download link: 5.16.0
Updates:
Added API operations to manage the analytical store of a time series table. For more information, see Create time series tables and Query information of an analytical store.
Date and time data can now be returned in the response of an SQL statement. For more information, see Query the date and time data.
Version: 5.13.15
Release date: 2023-04-03
Download link: 5.13.15
Updates: Optimized the internal SDK.
Version: 5.13.13
Release date: 2023-01-17
Download link: 5.13.13
Updates: Optimized the internal SDK and fixed bugs.
Version: 5.13.9
Release date: 2022-05-15
Download link: 5.13.9
Updates: Search indexes now support date data. For more information, see Create a search index.
Version: 5.13.5
Release date: 2022-01-06
Download link: 5.13.5
Updates:
You can now delete time series metadata in the TimeSeries model. For more information, see Delete time series.
You can now sort queried time series data in the TimeSeries model in reverse chronological order. For more information, see Query time series data.
Version: 5.13.0
Release date: 2021-11-17
Download link: 5.13.0
Updates: Added the SQL query feature. For more information, see SQL query.
Version: 5.12.0
Release date: 2021-10-27
Download link: 5.12.0
Updates: Added the TimeSeries model. For more information, see TimeSeries model.
Version: 5.11.0
Release date: 2021-07-23
Download link: 5.11.0
Updates:
Added the virtual column feature to search indexes. For more information, see Virtual columns.
Search indexes now support aggregation by percentile and aggregation by histogram. For more information, see Aggregation.
Version: 5.10.3
Release date: 2020-10-26
Download link: 5.10.3
Updates:
Added the data delivery feature. For information about how to deliver data to Object Storage Service (OSS) in the Tablestore console or using Tablestore SDKs, see Use the Tablestore console to deliver data to OSS and Deliver data to OSS using an SDK.
Search indexes now support querying rows from the results of an aggregation operation in each group. For more information, see Aggregation.
Added format checks for configuration parameters.
Optimized the SDK integration with compute engines.
Version: 5.7.0
Release date: 2020-04-07
Download link: 5.7.0
Updates:
Search indexes now support parallel scan. For more information, see Parallel scan.
Optimized TableStoreWriter.
Version: 5.4.0
Release date: 2019-11-18
Download link: 5.4.0
Change history
You can now add or delete predefined columns in existing tables.
The internal SDK for Tunnel Service has been optimized.
You can now create encrypted tables. For more information, see Create an encrypted table.
Version: 5.3.0
Release date: 2019-09-10
Download link: 5.3.0
Updates: Added the statistical aggregation feature to search indexes.
Version: 5.1.0
Release date: 2019-07-01
Download link: 5.1.0
Updates: Added more tokenizer types for search indexes.
Version: 5.0.0
Release date: 2019-06-10
Download link: 5.0.0
Updates:
Increased the version number to 5.x to align with other SDKs. Version 5.x is compatible with 4.x SDK interfaces.
Added the exists query for search indexes.
Version: 4.12.1
Release date: 2019-05-08
Download link: 4.12.1
Updates: Added the TimelineV2 model.
Version: 4.10.2
Release date: 2019-03-11
Download link: 4.10.2
Updates:
Removed the log4j2 implementation and log4j2.xml.
TunnelWorker: Fixed the auto-retry logic for poor network conditions.
Version: 4.7.4
Release date: 2018-09-27
Download link: 4.7.4
Updates:
Added the search index feature. The following query types are supported:
Multi-field search
Range query
Wildcard query
Nested query
Full-text search
Sorting
Added the global secondary index feature.
Version: 4.0.0
Release date: 2016-08-01
Download link: 4.0.0
Updates:
Added the TTL feature. For more information, see Time to live (TTL).
Added the max versions feature. For more information, see Data versions and TTL.
Version: 2.2.4
Release date: 2016-05-12
Download link: 2.2.4
Updates:
Added conditional updates.
Added filters.
Version: 2.1.0
Release date: 2015-11-12
Updates:
Implemented asynchronous network transmission and performance tuning, increasing queries per second (QPS) severalfold at the same CPU usage.
Provided flexible asynchronous APIs that support callbacks and return futures.
Decoupled the SDK from the OSS SDK. The new SDK contains only Tablestore-related code, with minor adjustments to the directory structure.
Optimized the retry logic. The default retry logic is improved, and single-row errors in batch operations can be retried individually. A clearer way to customize the retry logic is also provided.
Optimized logging. Logs are now recorded for each stage of a request. Slow request logs are supported. Trace IDs link the full chain of logs between the SDK and backend services.
Provided the OTSWriter API for easy and efficient batch data import.
Other optimizations: Added more utility functions for various data types and provided an API to calculate data size.
Important:
Version 2.1.0 has the following minor incompatibilities with version 2.0.4:
You must change the import paths for a few classes after you replace the SDK because the packages for some classes were adjusted. For example, the package for ClientConfiguration changed from com.aliyun.openservices to com.aliyun.openservices.ots. The packages were adjusted because the Tablestore SDK is now separate from the OSS SDK, making it more reasonable to place the previously shared classes under the ots package.
When you no longer use an OTSClient instance, such as before your program exits, you must call the `shutdown` method of the OTSClient to release the threads and connection resources that the OTSClient object holds.
Some configuration item names in ClientConfiguration are changed. For example, time units are added to the names.
The new SDK has different package dependencies, such as HttpAsyncClient and Joda-Time. If you encounter issues during runtime, check for conflicting dependencies.
Version: 2.0.4
Release date: 2015-09-25