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 incompatible with SDKs in the 2.x.x series.
Version 5.17.7
Release date: 2025-11-06
Download: 5.17.7
Changes:
Added Global Tables support.
Added the FLATTENED type for search indexes.
Added throttling by tag for search indexes.
Version 5.17.6
Release date: 2025-05-06
Download: 5.17.6
Changes:
The vector field type now supports the bytes format.
Added the IP data type for search indexes.
Added the JSON data type for search indexes.
Translated code comments from Chinese to English.
Updated the Protobuf version to 4.28.2.
Version 5.17.5
Release date: 2025-01-13
Download: 5.17.5
Changes:
Removed the synchronization status from search index query responses.
Optimized the `readMaxTimesPerRound` logic of TunnelClient.
Added the `minScore` and `numCandidates` parameters for AISearch in search indexes.
Added the `trackTotalCount` parameter to search indexes.
Added the post-query filtering feature for search indexes.
Added access denied details to permission-related exceptions.
Added CredentialsProvider-based authentication for TunnelClient.
Version 5.17.4
Release date: 2024-09-04
Download: 5.17.4
Changes: Added the `updateFullRow` parameter to the TableOptions configuration.
Version 5.17.2
Release date: 2024-06-21
Download: 5.17.2
Changes:
Added a case-sensitivity option for tokenization.
Allowed an empty measurement name for time series tables in the Time Series Model.
Version 5.17.1
Release date: 2024-05-29
Download: 5.17.1
Changes:
Added custom time series identifiers and data fields as primary keys for time series models.
Added Lastpoint index support for time series models.
Added the k-nearest neighbor (KNN) vector query feature for search indexes. For more information, see AISearch.
Version 5.16.3
Release date: 2023-09-07
Download: 5.16.3
Changes:
Added analytical store deletion support.
Added DNS caching with background refresh.
Version 5.16.1
Release date: 2023-08-17
Download: 5.16.1
Changes:
Added V4 signature support for identity authentication.
Added the TableStoreReader class for concurrent batch data queries. For more information, see Read data.
Added date histogram statistics for search indexes. For more information, see Aggregation.
Optimized internal SDK components.
Version 5.16.0
Release date: 2023-07-28
Download: 5.16.0
Changes:
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.
Added date and time data types to SQL query responses. For more information, see Query the date and time data.
Version 5.13.15
Release date: 2023-04-03
Download: 5.13.15
Changes: Optimized internal SDK components.
Version 5.13.13
Release date: 2023-01-17
Download: 5.13.13
Changes: Optimized internal SDK components and fixed bugs.
Version 5.13.9
Release date: 2022-05-15
Download: 5.13.9
Changes: Added date data support for search indexes. For more information, see Create a search index.
Version 5.13.5
Release date: 2022-01-06
Download: 5.13.5
Changes:
Added time series metadata deletion for the TimeSeries model. For more information, see Delete time series.
Added reverse chronological ordering for time series data queries in the TimeSeries model. For more information, see Query time series data.
Version 5.13.0
Release date: 2021-11-17
Download: 5.13.0
Changes: Added the SQL query feature. For more information, see SQL query.
Version 5.12.0
Release date: 2021-10-27
Download: 5.12.0
Changes: Added the TimeSeries model. For more information, see TimeSeries model.
Version 5.11.0
Release date: 2021-07-23
Download: 5.11.0
Changes:
Added the virtual column feature to search indexes. For more information, see Virtual columns.
Added aggregation by percentile and aggregation by histogram for search indexes. For more information, see Aggregation.
Version 5.10.3
Release date: 2020-10-26
Download: 5.10.3
Changes:
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.
Added row retrieval within aggregation groups for search indexes. For more information, see Aggregation.
Added format validation for configuration parameters.
Optimized the SDK integration with compute engines.
Version 5.7.0
Release date: 2020-04-07
Download: 5.7.0
Changes:
Added parallel scan support for search indexes. For more information, see Parallel scan.
Optimized TableStoreWriter.
Version 5.4.0
Release date: 2019-11-18
Download: 5.4.0
Changes:
Added predefined column management (add and delete) for existing tables.
The internal SDK for Tunnel Service has been optimized.
Added encrypted table creation support. For more information, see Create an encrypted table.
Version 5.3.0
Release date: 2019-09-10
Download: 5.3.0
Changes: Added the statistical aggregation feature to search indexes.
Version 5.1.0
Release date: 2019-07-01
Download: 5.1.0
Changes: Added more tokenizer types for search indexes.
Version 5.0.0
Release date: 2019-06-10
Download: 5.0.0
Changes:
Bumped the version number to 5.x for alignment across SDKs. Version 5.x is backward compatible with 4.x SDK interfaces.
Added the exists query for search indexes.
Version 4.12.1
Release date: 2019-05-08
Download: 4.12.1
Changes: Added the TimelineV2 model.
Version 4.10.2
Release date: 2019-03-11
Download: 4.10.2
Changes:
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: 4.7.4
Changes:
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: 4.0.0
Changes:
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: 2.2.4
Changes:
Added conditional updates.
Added filters.
Version 2.1.0
Release date: 2015-11-12
Changes:
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:
After replacing the SDK, update the import paths for classes whose packages changed. 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.
Before your program exits or when an OTSClient instance is no longer needed, 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