ApsaraDB RDS for MySQL periodically releases minor version updates for its database proxy, covering new features, performance improvements, and bug fixes. This page lists release notes for each version and explains how to check your current version.
To upgrade the minor engine version of the database proxy, see Upgrade the minor engine version of a database proxy. For ApsaraDB RDS for MySQL kernel release notes, see AliSQL kernel minor version release notes.
Check the proxy minor engine version
View the current version: On the Database Proxy page, the current version appears under Basic Information > Proxy Minor Version.

View available upgrades: Click Upgrade next to Proxy Minor Version to see the Upgradable Versions.
If the proxy is already on the latest version, the Upgrade button is not displayed. To check the version programmatically, call DescribeDBProxy.
Version release notes
The following sections cover mainstream versions only and do not include every released version. Your proxy version may not appear in this list.
2.25.10
New features
Transaction-level connection pooling now supports tracking for
collation_connection.
Bug fixes
Fixed an issue where incompatible SQL statements in hybrid transactional and analytical processing (HTAP) scenarios were not rerouted to transactional processing (TP) nodes.
Fixed an issue where load imbalance occasionally occurred after a read-only transaction ran in a single session.
Fixed an issue where high transient latency on the primary database in a high availability (HA) architecture caused connection drops.
2.25.9
New features
Optimized the performance of consistent reads in low-concurrency scenarios.
Bug fixes
Fixed an issue where persistent connections experienced unexpected transient disconnections due to the HTAP feature.
2.25.8
New features
Added support for automatic request distribution among row store and column store nodes for HTAP.
Bug fixes
Fixed an issue where replaying a failed read request to the primary node could cause a crash.
2.25.7
Bug fixes
Fixed an issue where consistent reads could fail during high write concurrency.
2.25.5
New features
Added support for transaction replay, which keeps persistent connections alive for in-progress transactions during a switchover.
Bug fixes
Fixed an issue where new connections could be blocked when the primary MySQL node restarted in place after a crash.
Fixed an issue where changing proxy parameters or nodes could cause uneven load balancing for some persistent connections.
2.25.4
New features
Added support for a load balancing routing policy based on the number of active requests. For details, see Load balancing algorithms.
Added support for configuring the primary node as a fallback node for the read-only proxy.
2.25.3
Bug fixes
Fixed an issue that caused occasional errors when establishing connections with transaction-level connection pooling.
2.25.2
New features
Added support for the consistent read feature for MySQL 5.6.
Bug fixes
Fixed an issue where a
SELECT FOR UPDATEstatement failed if a column name was the keyworddisable.Fixed an issue where sessions were unexpectedly disconnected due to
wait_timeout.
2.25.1
New features
Added support for setting the read consistency level for read/write splitting.
2.24.3
Bug fixes
Fixed an issue where a
SELECT FOR UPDATEstatement failed if a column name was the keyworddisable.Fixed an issue where sessions were unexpectedly disconnected due to
wait_timeout.Fixed a schema error caused by the transaction-level connection pool when adding a read-only node.
2.24.1
Bug fixes
Fixed an out-of-memory (OOM) issue caused by an excessively large recv-q for backend connections.
Fixed an issue where the schema was incorrectly reused by the transaction-level connection pool when adding a node.
2.9.5
New features
Added support for setting the minimum number of reserved instances.
Bug fixes
Fixed an issue where the bandwidth of a single connection was limited under high network latency.
Fixed an issue where load balancing could become uneven after a failed node recovered.
2.9.3
Bug fixes
Fixed an issue where load balancing could become uneven for some persistent connection scenarios in read/write splitting mode.
Fixed a memory leak caused by the
SHOW WHEREstatement, introduced in version 2.9.1.
2.9.1
New features
Added support for configuring a connection pool and latency threshold for read-only endpoints.
Added support for persistent connections during passive switchovers.
Optimized persistent connections to support transactions with no write operations under the Read Committed (RC) isolation level.
Bug fixes
Fixed a
thread id already existserror caused by thread ID rotation. Thread IDs are now less likely to rotate.Fixed an issue where a
Kill Queryoperation on a read-only address was not broadcast, which could prevent the request from being killed.
2.8.41
New features
Upgraded the kernel to community version 2.3.15.
Before upgrading to this version, make sure your ApsaraDB RDS for MySQL instance is on minor engine version 20240131 or later. To upgrade the instance version, see Upgrade the minor engine version.
1.14.8/1.14.9
Bug fixes
Fixed an issue where a
Killstatement could cause a session to hang.Fixed an issue where sessions on a read-only node with a weight of 0 could not be killed.
Fixed an issue where the bandwidth of a single connection was limited under high network latency.
Fixed an issue where load balancing could become uneven after a failed node recovered.
Fixed an issue where a hung MHD thread caused task stream failures.
Fixed a memory leak that occurred when the system processed short-lived connections.
Fixed an issue where the
force_nodesyntax did not take effect.
1.14.7
New features
Added a performance monitoring metric for the number of persistent connection failures.
Bug fixes
Fixed a Java Database Connectivity (JDBC) error that occurred during an upgrade from MySQL 5.7 to 8.0.
Fixed an issue where locking a MySQL 5.6 instance could cause connection authentication to fail for the cluster.
Fixed an issue where the proxy protocol failed after a quick restart of a crashed MySQL 5.7 instance.
Fixed an issue where requests could fail during database and table recovery.
1.14.6
New features
Added the persistent connection feature for active switchover scenarios.
1.14.5
Bug fixes
Added compatibility with the session tracker of MySQL 8.0.33. This fixes an issue where client connections could be dropped after the connection pool feature was enabled.
1.14.3/1.14.4
Bug fixes
Fixed an issue where the dual-write protection feature incorrectly identified the primary node, making the proxy endpoint unavailable. An error code is now returned to the client when this feature is triggered.
Fixed an issue where proxy endpoint authentication failed if the account host was in CIDR format.
Fixed an issue where the first read statement in a transaction was forwarded to a read-only node when transaction splitting was disabled.
1.14.1/1.14.2
New features
Added a dual-write protection feature to prevent data write errors caused by a dual-primary scenario during an abnormal switchover. When enabled and multiple primary nodes exist, the proxy endpoint becomes unavailable.
1.13.42
Bug fixes
Fixed an issue where connection establishment failed due to an excessive number of database connections.
Fixed an issue where an internal scheduled task caused response time (RT) jitter.
1.13.41
Performance improvements
Optimized proxy performance in scenarios with many failed authentication attempts.
Refined the identity verification feature: throttling now operates at account-level granularity instead of global granularity.
Bug fixes
Fixed an issue where the transaction resolution was lost during transaction splitting.
Fixed an issue where environment variables were not reset in the transaction-level connection pool.
Fixed an issue where a prepared statement failed to close in a distributed transaction (XA transaction).
Fixed several internal exceptions.
1.13.33
New features
Added support for the MySQL
utf8mb3encoding format.
Bug fixes
Fixed an issue where a
SELECT FOR UPDATEstatement was incorrectly routed due to an excessive number of parameters in a prepared statement.
1.13.27
Performance improvements
Optimized proxy parsing performance for
INSERTstatements.
Bug fixes
Fixed several Secure Sockets Layer (SSL) compatibility issues with clients.
1.13.25
Bug fixes
Fixed a memory leak caused by authentication failures.
Fixed an issue where the proxy could unexpectedly crash in multi-Endpoint scenarios.
1.13.22
New features
Added support for using
SELECT LAST_INSERT_ID()to get the unique ID of a sharded table after anINSERToperation.Added support for the
FOUND_ROWS()function.Added support for routing
COM_STATISTICSto read-only instances.Optimized the transaction-level connection pool.
Added support for routing GEO functions to read-only instances.
Added internal monitoring metrics.
Bug fixes
Connections are no longer sent to locked instances in ApsaraDB RDS.
Fixed routing errors caused by incorrect parsing of some statements.
Fixed an issue where
stmt_execfailed in some scenarios.Fixed an issue where the
load data infilestatement failed to execute.
1.13.17
Bug fixes
Fixed several internal faults.
1.13.5
New features
Added support for routing all requests on a connection to a specified node (Force Node Connection). Use the syntax
/*force_proxy_internal*/set force_node = 'pi-123';to route all subsequent requests to nodepi-123.If the specified node is unavailable, the proxy returns the error:
set force node 'pi-123' is not found, please check.Added support for routing a single request to a specified node (Force Node Query). Use the syntax
/*force_node='pi-123'*/ show processlist;to route the request to nodepi-123.If the specified node is unavailable, the proxy returns the error:
'force hint server node is not found, please check'.Added internal monitoring metrics.
Bug fixes
Fixed an issue where requests were routed to a read-only instance if the statement contained the
MODEkeyword.Fixed an issue that caused uneven load balancing under certain conditions.
1.12.10
New features
Added SSL encryption support for dedicated proxy connection addresses.
Bug fixes
Fixed an issue where establishing an SSL connection failed for MySQL 8.0.
Fixed an issue where the dedicated proxy failed to route new requests to a node after the node recovered from an abnormal state.
1.12.7
New features
Added support for the
SHOW FULL PROCESSLISTsyntax.Added support for the XA transaction syntax.
Bug fixes
Fixed an error with the
SHOW PROCESSLISTstatement for MySQL 8.0.Fixed several issues with the transaction-level connection pool.
Fixed several issues that caused connection establishment to fail.
1.11.12
New features
Added support for transaction-level connection pooling.
Bug fixes
Optimized load balancing for persistent connections so that new requests on existing connections can be routed to a node after it recovers from an abnormal state.
Optimized the Prepare syntax to support Prepare unicast.
Fixed a connection failure when a MySQL 5.7 client connected to a MySQL 5.6 database with Deprecate EOF enabled.
Fixed an issue where the connection was dropped when the database was changed within a stored procedure.
Fixed an issue where the client reported a
Packets out of ordererror if a single row in a result set with large messages exceeded 16 MB.Fixed an issue where transactions opened on a read-only instance using
SET autocommit=0were not closed promptly.Fixed an issue where
LOCK IN SHARE MODEstatements were routed to a read-only instance.Fixed an issue where
SELECT handler FROM abc FOR UPDATEstatements were routed to a read-only instance.Fixed an authentication failure for a single user with multiple hosts.
1.10.7
Bug fixes
Fixed several issues with the session-level connection pool.
1.9.23
New features
Added support for root account connections.
Added SSL connection support.
Bug fixes
Fixed an issue where
CHANGE USERfailed.Fixed an issue where
LOAD FILEfailed.Fixed an issue where the application reported an
Exception: Packets out of ordererror because the client received an incorrect sequence message.Fixed an issue where connections to read-only instances were dropped when the primary instance was abnormal.
1.9.14
New features
Added support for hint syntax:
/*FORCE_SLAVE*/and/*FORCE_MASTE*/.
Bug fixes
Fixed an issue that caused garbled characters because the default charset value was incorrect.
Fixed an issue where an incorrect string was returned for the MySQL version number.
References
API reference
| API | Description |
|---|---|
| DescribeDBProxy | Queries the details of a database proxy. |