How to update the minor version in the ApsaraDB for HBase console - ApsaraDB for HBase

This topic describes how to update the minor version of an ApsaraDB for HBase cluster in the ApsaraDB for HBase console and provides the release notes.

Important

The ApsaraDB for HBase service is not interrupted during the update. The system performs a rolling restart to upgrade the cluster. Before a RegionServer restarts, all its regions are moved to other servers to minimize the impact on your business. Network jitter may occur during the update, but the cluster remains available, which lets you safely upgrade the cluster.
The update duration varies based on the cluster size and the number of regions. For example, an update for a cluster with 2 core nodes and 100 regions typically takes less than 10 minutes to complete. However, for a large cluster with thousands of regions, the update may take more than one hour.

Procedure

Log on to the ApsaraDB for HBase console.
In the upper-left corner of the top navigation bar, select the region of your instance.
On the Clusters page, click the ID of the target instance.
In the navigation pane on the left, select Database Connection.
In the upper-right corner of the page, click Upgrade Minor Version.

Release notes

Version number	Release date	Category	Description
2.8.2	September 7, 2025	New feature	You can now use Lindorm SQL to estimate the row count of statistical tables.
2.8.2	September 7, 2025	Feature optimizations	Improves the user experience of features such as range deletion, column deletion, and index building. Optimizes the load balancing performance when an instance contains many tables. Optimizes SQL on HBase features. Improves HBase protocol compatibility. Includes other stability fixes.
2.8.0	March 27, 2025	New feature	You can enable the SQL Audit Log. Added the Cursor-based paging (public preview) feature. Added a time function to process time data. The ALTER SYSTEM command adds the new configuration item `ERROR_LANG` to set the language for SQL exception messages. Aggregate functions now include the HEAD function. Lindorm-cli supports connecting to LindormTable via the MySQL protocol.
2.8.0	March 27, 2025	Feature optimizations	Adds a memory protection feature for SQL queries to prevent out of memory (OOM) errors. Fixes an issue where performance degrades when the SQL engine is rolled back to `sqlv2`. Improves the pushdown performance of global queries (`Select *`). Fixes an issue where SQL performance degrades after Secure Sockets Layer (SSL) encryption is enabled. Improves HBase protocol compatibility. Improves SQL on HBase compatibility. Improves cache replacement speed when the query pattern changes frequently to enhance query stability.
2.7.6	December 6, 2024	New feature	The MySQL-style time zone can be configured. For more information, see Set a connection time zone. The full-text search function MATCH is supported. For more information, see MATCH function. SQL audit logs can be viewed in the console. For more information, see SQL Audit Log. You can use the Python connector (mysql-connector-python) to connect to LindormTable. For more information, see Develop applications using Python (mysql-connector-python).
2.7.6	December 6, 2024	Feature optimizations	Optimizes the execution logic for aggregation requests to improve performance. Optimizes the logic for building secondary indexes on historical data to resolve occasional build failures. Optimizes the request retry logic to reduce errors that may occur during shard migration or splitting. Optimizes the execution logic for `IN` requests to improve the efficiency of queries that contain many `IN` clauses. Further optimizes the automatic hot spot detection and resolution logic for finer-grained identification and handling of hot spot shards. Improves compatibility with the HBase protocol. Improves compatibility with and enriches the support for MySQL syntax. Includes other stability fixes.
2.7.1	July 11, 2024	New feature	Expressions that include the MD5 or SHA256 function can be specified as secondary index keys. For more information, see Secondary index function expressions (function_expression). You can execute SQL statements to configure the maximum number of connections to LindormTable. For more information, see ALTER SYSTEM configuration items. Lindorm Ganos now supports grid secondary indexes. For more information, see Grid secondary indexes. Grid indexes support intersection queries.
2.7.1	July 11, 2024	Feature optimizations	Improves the performance of SQL point queries. Supports building indexes on historical data for multiple index tables of a single table at the same time. Enriches the status and progress information for building secondary indexes on historical data. Includes other stability fixes and improves compatibility with and enriches the support for MySQL syntax.
2.6.5	March 25, 2024	New feature	Search indexes support new parameters: INDEX_SETTINGS for index attributes and mapping for index key attributes. For more information, see Index key definition (index_key_definition) and Search index key attributes. Ganos spatiotemporal service supports grid secondary indexes. For more information, see Grid secondary indexes. Ganos spatio-temporal service supports H3 functions for efficient spatio-temporal queries and analysis based on H3 grids. For more information, see H3 functions.
2.6.5	March 25, 2024	Feature optimizations	Improves compatibility with and enriches the support for MySQL syntax. Lindorm SQL supports physical plan reuse to optimize query performance. Building secondary indexes on historical data is not affected by cold storage. Optimizes compatibility with the native HBase client protocol. If you use an open source HBase client to access Lindorm, upgrade the LindormTable engine to this version or later.
2.6.2	November 8, 2023	New feature	Supports the MySQL-compatible protocol. For more information, see Use the MySQL protocol (recommended).
2.5.6	August 18, 2023	Feature optimizations	Fixes HBase protocol compatibility issues. Fixes an issue of unbalanced loads across multiple groups. Includes other stability fixes.
2.5.3	May 24, 2023	New feature	Supports Wildcard columns.
2.5.3	May 24, 2023	Feature optimizations	Fixes an issue where SQL requests may time out during short-circuit reads and writes. Note For a better read and write experience, upgrade the LindormTable engine to 2.5.3 or later if you use SQL. Fixes a compatibility issue that occurs when using the batch interface of an open source HBase client. Fixes an issue of excessive meta requests when using an open source HBase client.
2.5.2	April 19, 2023	New feature	Lindorm SQL supports deleting existing columns from a table. For more information, see ALTER TABLE.
2.5.2	April 19, 2023	Feature optimizations	Improved the user experience of using SQL statements to access ApsaraDB for HBase tables. Improves the query experience in hot and cold data separation scenarios. Improves the performance of asynchronous audit logging. Improves compatibility with the HBase client protocol. Increases the upper limit on the number of files monitored per region. Optimizes the execution efficiency of Aggregate statements. Optimizes CPU consumption caused by data expiration in short TTL scenarios.
2.4.3	March 10, 2023	Feature optimizations	Improves the Lindorm SQL user experience. Includes other stability fixes.
2.4.2	December 13, 2022	New feature	Supports accessing the LindormTable engine directly from open source HBase clients. Supports hot and cold data separation based on a custom time column (recommended for Lindorm SQL users).
2.4.2	December 13, 2022	Feature optimizations	Improves the user experience of the JSON data type. Includes other stability fixes.
2.4.1	November 1, 2022	Feature optimizations	Improves the user experience of Lindorm Ganos spatio-temporal features. Fixes bugs in Lindorm SQL.
2.4.0	October 9, 2022	New feature	You can use SQL to access HBase tables.
2.4.0	October 9, 2022	Feature optimizations	Improves the Lindorm SQL user experience.
2.3.4	August 30, 2022	Feature optimizations	Improves the Lindorm SQL user experience.
2.3.3	August 16, 2022	Feature optimizations	Adds a feature for automatic hot spot detection and handling. Adds the ST_DWithin and ST_DWithinSphere functions to the spatio-temporal engine. Includes other stability fixes.
2.3.2	August 2, 2022	Feature optimizations	Optimizes Lindorm SQL syntax. Supports more Lindorm Ganos spatiotemporal features.
2.3.1	June 30, 2022	New feature	Supports the Lindorm Ganos spatio-temporal feature.
2.2.21	April 25, 2022	Feature optimizations	Optimizes DirectMemory consumption during writes. Optimizes the load balancing policy. Optimizes compaction parameters and supports automatic adjustments. Improves index building speed. Optimizes the read and write performance of SQL.
2.2.20	March 16, 2022	Feature optimizations	Optimizes write performance for large key-value pairs. Lindorm SQL supports reading multiple data versions and writing data with custom timestamps. Fixes other performance issues.
2.2.19	February 9, 2022	New feature	Lindorm SQL supports dynamic columns and SQL layer monitoring.
2.2.19	February 9, 2022	Feature optimizations	Fixes an issue of delayed metadata updates after Lindorm SQL table properties are modified. Fixes stability issues.
2.2.18	January 5, 2022	Feature optimizations	Optimizes Lindorm SQL performance. Fixes time zone issues for the Date and Time data types in Lindorm SQL. Fixes stability issues.
2.2.17	December 17, 2021	Feature optimizations	Fixes bugs in Lindorm SQL. Improves the online speed of cold storage regions. If you use cold storage, upgrade the LindormTable engine to 2.2.17 or later.
2.2.16	November 12, 2021	Feature optimizations	The syntax of Lindorm SQL statements is improved. If you use Lindorm SQL statements, we recommend that you upgrade the version of your LindormTable to 2.2.16 or later. Optimizes the disk flush logic to prevent out of memory errors when there are too many regions. Fixes other bugs.
2.2.15	October 18, 2021	Feature optimizations	Optimized the use of Lindorm SQL and fixed issues where tables failed to be created in some cases and access to strongly consistent tables failed. We recommend that you upgrade your cluster to this version or a later version.
2.2.12	September 6, 2021	Feature optimizations	Optimizes the compaction policy to improve efficiency. Optimizes the amount of data returned by Scan operations.
2.2.11	August 25, 2021	New feature	Lindorm SQL statements are supported. Supports high-performance native secondary indexes.
2.2.10	August 12, 2021	Feature optimizations	Fixes an issue where requests to cold storage fail due to network jitter. Upgrade to this version or later.
2.2.9	June 9, 2021	New feature	The multi-dimensional index (SearchIndex) feature supports dynamic generation of tokenizer configurations and includes some bug fixes.
2.2.8	March 25, 2021	Feature optimizations	Optimizes memory usage during zstd compression.
2.2.7	March 11, 2021	New feature	Supports sequential data export from Lindorm. This feature requires Lindorm Tunnel Service (LTS).
2.2.5	January 7, 2021	New feature	Supports incremental data export from Lindorm. This feature requires LTS.
2.2.1	September 9, 2020	Feature optimizations	Optimizes the multi-dimensional index (SearchIndex) feature and fixes some bugs.
2.1.30	October 26, 2020	Feature optimizations	Optimizes the region selection algorithm for flushing in write hot spot scenarios.
2.1.26	October 9, 2020	Feature optimizations	Optimizes the memory overhead of BucketCache for small-specification instances.
2.1.25	September 30, 2020	Feature optimizations	Reduces the amount of redundant data retrieved during reverse scans.
2.1.23	September 22, 2020	Feature optimizations	Optimizes memory management for low-memory machine types.
2.1.21	July 20, 2020	Feature optimizations	Upgrade to this version or later. Optimizes write throughput. Optimizes reverse scan performance. Optimizes the speed of archiving data from hot storage to cold storage in the hot and cold data separation feature.
2.1.17	March 20, 2020	Feature optimizations	Improves the usability of the multi-dimensional index (SearchIndex) feature.
2.1.15	February 6, 2020	Feature optimizations	Optimizes the multi-dimensional index (SearchIndex) feature and fixes some bugs.
2.1.12	December 16, 2019	Feature optimizations	Optimizes the multi-dimensional index (SearchIndex) feature and fixes issues encountered during the bulk load process.
2.1.10	November 16, 2019	New feature	Supports the multi-dimensional index (SearchIndex) feature.
2.1.10	November 16, 2019	Feature optimizations	Optimizes the hot and cold data separation feature.
2.1.9	October 8, 2019	New feature	Added support for the SearchIndex feature and fixed some bugs.
2.1.8	September 9, 2019	New feature	Supports the cold storage and hot and cold data separation features.