All Products
Search
Document Center

PolarDB:PolarProxy release notes

Last Updated:Jul 17, 2026

These are the release notes for PolarProxy for PolarDB for MySQL.

For questions about versions or proactive O&M upgrades, join our DingTalk group (group ID: 51685000218).

Version management

The database proxy for PolarDB for MySQL uses two versioning tracks:

  • New purchase version: The version number assigned to new instances.

  • Stable version: The target version number for proxy minor version upgrades.

The risk level of a release determines whether it becomes a new purchase version only, or both a new purchase version and a stable version. A bug-fix release becomes both a new purchase version and a stable version. A major feature release becomes a new purchase version only. A new purchase version becomes a stable version two to three months after its release.

Check the version number

Log in to the PolarDB console and navigate to the Settings and Management > Version Management page for your target cluster. In the Version Information section, you can view the current and latest versions of PolarProxy (for example, current 2.4.18, latest 2.4.22) and the database kernel engine (for example, current 8.0.1.1.17, latest 8.0.1.1.18). In the Upgrade Version section, you can upgrade the PolarProxy, database kernel engine, and Store components individually or together.

PolarProxy for PolarDB for MySQL has two major versions: 1.x.x and 2.x.x.

  • 1.x.x

    This version is for clusters created before February 1, 2021. It no longer receives feature updates, only bug fixes.

  • 2.x.x

    This version is for clusters created on or after February 1, 2021. It is the current mainstream version and supports new features, such as persistent connections and data masking.

Note
  • To upgrade from version 1.x.x to 2.x.x, your cluster's kernel version must meet the following requirements:

    • If your cluster runs PolarDB for MySQL 8.0.2, there are no kernel version requirements.

    • If your cluster runs PolarDB for MySQL 8.0.1, the minor version must be 8.0.1.1.10 or later.

    • If your cluster runs PolarDB for MySQL 5.7, the minor version must be 5.7.1.0.6 or later.

    • If your cluster runs PolarDB for MySQL 5.6, the minor version must be 5.6.1.0.24 or later.

  • See minor version management for details on upgrading the PolarProxy version.

PolarProxy release log

Database proxy 2.x.x release notes

Note

This list of mainstream PolarProxy versions is not exhaustive and may not include your version.

  • 2.9.22 (Release Date: 2026-07-13)

    Category

    Description

    New features

    • Supported routing requests that contain built-in functions such as JSON_ARRAYAGG to read-only nodes.

    Bug fixes

    • Fixed an issue where multi-primary clusters occasionally experienced random routing failures.

    • Fixed an issue where multi-primary clusters failed to correctly retry requests on read-only (RO) nodes in certain error scenarios.

    • Fixed an issue where data masking or encryption functions could cause a session to hang in multi-packet response scenarios.

    • Fixed an issue where releasing a non-existent prepared statement (prepare) directly closed the connection.

  • 2.9.21 (Release Date: 2026-04-23)

    Category

    Description

    New features

    • Supports socket hot migration, enabling you to upgrade the database proxy without disconnecting client connections for seamless application updates.

      Note

      This feature is in a canary release and is disabled by default. To enable this feature, please submit a ticket.

    • Supports monotonic reads with eventual consistency. This ensures that within the same session, subsequent reads do not return data older than that from previous reads.

    • Supports the document database protocol (NoSQL), including CRUD, aggregation, index management, and user authentication.

    Performance optimizations

    • Improved SQL parsing speed and reduced SQL parsing overhead.

    • If no columnar index read-only node is available, requests that include the force_imci_nodes hint can fall back to a row-store read-only (RO) node to prevent execution errors.

    • Improved connection retention during a failover when both Binlog and a hot standby node are enabled.

    Bug fixes

    • Fixed a crash caused by non-ping-pong packet sending that led to out-of-order states in data masking or encryption scenarios.

    • Fixed a crash in data masking scenarios caused by abnormal subquery processing logic.

    • Fixed a crash during Binlog pulls from a cluster endpoint, caused by the misidentification of normal packets larger than 16 MB as error packets.

    • Fixed a connection reuse failure during the handshake phase of a transaction-level connection pool, caused by the client sending an invalid character set number.

    • Fixed the incorrect routing of EXPLAIN SELECT to a columnar index read-only node when no row-store read-only (RO) node was available for the cluster endpoint.

    • Fixed the incorrect routing of read requests to the primary node, caused by the misidentification of the DECIMAL(m,n) type in the CONVERT function as a user-defined function.

    • Fixed inaccurate average request latency metrics for the database proxy displayed in the console, which occurred in scenarios with a high percentage of broadcast commands (such as PING).

  • 2.9.20 (Release date: 2026-04-03)

    Category

    Description

    Bug fix

    • Fixed a bug introduced in version 2.9.17 where the proxy would crash during parsing by misinterpreting a normal packet as an error. This occurred when a binlog session was established via a PolarDB read/write splitting endpoint, the first binlog packet exceeded 16 MB, and the byte at the packet splitting position was 0xFF.

  • 2.9.19 (Release date: 2025-12-25)

    Category

    Description

    Performance Optimizations

    • Streamlined the execution of Prepared Statements.

    Bug Fixes

    • Fixed a potential memory leak when executing a binary PREPARE statement with a hint on a cluster endpoint that includes a columnstore index read-only node.

    • Fixed an issue that caused a session to hang upon timeout while waiting for client authentication information.

    • Fixed a compatibility issue with PolarDB Always-confidential that occurred when executing specific SQL statements.

    • Fixed an issue that caused the DROP TABLE statement to hang when dropping a large number of tables.

  • 2.9.18 (Released: November 19, 2025)

    Category

    Description

    Performance optimizations

    • Optimized the proxy's health check logic for columnstore index read-only nodes. This prevents sessions from hanging due to health check exceptions and improves the stability of analytical queries.

    Bug fixes

  • 2.9.17 (Release date: 2025-11-07)

    Category

    Description

    Performance optimizations

    • Optimized routing for Multi-master Cluster (Limitless), routing requests for the SHOW TABLE STATUS from db_name statement to the specified read/write (RW) node to ensure data consistency when you retrieve table status information.

    • Optimized the read-only transaction processing mechanism. Sessions now stay connected if a node fails while processing a read-only transaction. This improves cluster high availability and business continuity during node failures.

    • Optimized the binlog pull performance for a Global Database Network (GDN) to address slow binlog pulling from the cluster endpoint of a secondary cluster.

      Note

      To enable this optimization, submit a ticket.

    Bug fixes

    • Fixed an issue where read-only transactions could cause a cluster to crash in specific scenarios.

    • Fixed a bug in the SQL firewall that could cause a cluster to crash when processing specific SQL statements.

    • Fixed a data decryption failure that occurred in PolarProxy versions 2.9.12 through 2.9.16 on clusters configured with PolarDB Always-confidential encryption rules.

  • 2.9.16 (Release date: 2025-09-17)

    Category

    Description

    Performance optimizations

    • Optimized error messages for routing failures with the /*FORCE_IMCI_NODES*/ hint.

    • Optimized the rule matching logic for dynamic data masking.

    Bug fixes

    • Fixed a routing issue with SELECT … FOR SHARE statements.

    • Fixed an issue where the SQL parser failed to recognize CHARACTER SET when parsing CAST.

    • Fixed an issue where routing binary PREPARE statements in a Multi-master Cluster (Limitless) Edition could cause unexpected disconnections in certain scenarios.

    • Fixed a routing issue with advanced transaction splitting when processing multi-statement scenarios.

    • Fixed an issue where the overload protection feature could cause unexpected disconnections in some scenarios.

    • Fixed an issue where a persistent connection could cause errors in XA requests.

  • 2.9.15 (Released on: 2025-07-17)

    Category

    Description

    New features

    Adds support for separately configuring global consistency on read-only endpoints with the Load balancing policy set to Active Request-based Load Balancing.

    Performance optimizations

    Bug fixes

  • (Released on: 2025-05-22)

    Category

    Description

    Bug fixes

    Fixed an issue where CPU utilization monitoring displayed inaccurate results.

  • 2.9.12 (Release date: 2025-05-15)

    Category

    Description

    New features & performance optimizations

    • Optimized global consistency (high-performance mode) by changing its scope from system-level to connection-level, allowing you to configure it for each PolarProxy endpoint.

    • Optimized the persistent connection switching process.

    • Optimized SQL parsing.

    • Optimized the transaction-level connection pool.

    • Optimized statistical metrics.

    Fixed issues

    • Fixed incorrect node binding for the Orca (Redis-compatible) Scan command and unexpected disconnections caused by wait timeout.

    • Fixed an issue where executing the last_used command disconnected on-demand connections.

    • Fixed a routing error in Multi-master Cluster (Limitless) Edition clusters caused by using SET autocommit=0 or SET autocommit=1 in multi-statement transactions.

    • Fixed a compatibility issue between the transaction-level connection pool and HTAP.

    • Fixed a consistency issue in read-only transactions.

    • Fixed compatibility issues with certain drivers.

    • Fixed an issue where connection reuse could incorrectly select a database in certain scenarios when the transaction-level connection pool is enabled.

  • 2.9.10 (Released on: 2025-02-14)

    Category

    Description

    Bug fixes

    • Fixed a query routing error for temporary tables created with the CREATE TEMPORARY TABLE * AS SELECT * FROM * statement.

    • Fixed an execution error for XA transactions on read-only endpoints configured with load balancing based on active requests.

    • Fixed a routing error for XA transactions in a multi-master cluster.

    • Fixed table creation errors in a multi-master cluster in some scenarios.

    • Fixed an error on read-only endpoints configured with load balancing based on active requests, caused by using the force_master/force_node hint to specify the primary node.

    • Fixed a bug that unexpectedly disconnected sessions after the wait_timeout period expired when pulling a binlog from a cluster endpoint.

  • 2.9.8 (Release Date: 2024-11-25)

    Category

    Description

    New features & performance optimizations

    • Now routes requests containing built-in GIS functions, such as ST_Distance_Sphere, to read-only nodes.

    • You can now configure timeout policies for high-performance strong consistency to forward requests to the primary node, return an error, or downgrade.

    • Supports global consistency in multi-master scenarios.

    • Added support for selecting specific primary nodes by using custom endpoints.

    • Improved load balancing for read-only nodes in multi-master scenarios.

    Bug fixes

    • Fixed a potential proxy OOM error in high-concurrency data read scenarios.

    • Fixed transaction resumption failures.

    • Fixed an incompatibility between accounts that use caching_sha2_password and the PyMySQL driver.

    • Fixed an issue where the force_node hint could become invalid during a primary/secondary failover.

    • Fixed a crash caused by proxy exceptions in some multi-master scenarios.

    • Fixed an issue where the proxy incorrectly identified the Standby role in some multi-master scenarios.

    • Fixed an issue where connection reuse could select an incorrect database after a primary/secondary failover when the transaction-level connection pool is enabled.

  • 2.9.4 (Release date: 2024-08-29)

    Category

    Description

    New features & performance optimizations

    always-confidential encryption now supports key updates.

    Bug fixes

    • Fixed an issue where temporary tables created in a stored procedure could not be accessed.

    • Fixed a bug that prevented CREATE TABLE LIKE and RENAME TABLE statements from executing in a Multi-master Cluster.

    • Fixed slow request responses for PolarDB for AI in high-concurrency scenarios.

    • Fixed proxy blocking and restart issues in some scenarios.

  • 2.9.2 (Released on: 2024-07-29)

    Category

    Description

    New features & performance optimizations

    • Added support for MySQL 8.0 caching_sha2_password authentication.

    • Added support for wildcards in encryption rules.

    • Optimized routing for statements that use Global Transaction Identifiers (GTIDs).

    • Added support for the ->> and -> JSON operators.

    Bug fixes

    • Fixed occasional connection failures caused by thread ID rotation in short-lived connection scenarios.

    • Fixed an error in multi-statement nested transactions.

    • Fixed proxy exceptions caused by parsing failures for some specific SQL statements.

  • 2.8.47 (Release Date: 2024-12-02)

    Category

    Description

    New Features & Performance Optimizations

    Added support for routing requests containing built-in GIS functions, such as ST_Distance_Sphere, to read-only nodes.

    Bug Fixes

    • Fixed a potential proxy OOM during high-concurrency data reads.

    • Fixed an issue where transaction resumption could fail in some scenarios.

    • Fixed an issue where connection reuse could use the wrong database after a primary/secondary failover when the transaction-level connection pool was enabled.

  • 2.8.46 (Release Date: 2024-09-13)

    Category

    Description

    New Features & Performance Optimizations

    • Improved download throughput for cross-region access or under extreme network conditions.

    • Optimized the routing for select information_schema.processlist to default to the primary node in the new version, preventing failures when you use gh-ost for lock-free schema changes.

    Bug Fixes

    • Fixed an issue that caused slow requests on read-only endpoints connected to a single read-only (AP) node.

    • Fixed incorrect user variable routing that caused an Illegal mix of collations error.

  • 2.8.45 (Released on: 2024-07-19)

    Category

    Description

    New features & performance optimizations

    • Optimized read-after-write splitting for transactions in certain scenarios.

    • Optimized persistent connections in certain scenarios.

    • Optimized the handling of non-payload data packets for data masking and encryption.

    Bug fixes

    • Fixed on-demand connection establishment failures in certain scenarios.

    • Fixed a compatibility issue between on-demand connection establishment and automatic request distribution between row and column stores.

    • Fixed incorrect request routing for automatic request distribution between row and column stores in some scenarios.

    • Fixed an issue where the proxy unexpectedly restarted during data decryption or encryption.

    • Fixed delayed overload protection recovery in specific scenarios that caused slow request responses.

    • Fixed unexpected disconnections when executing a binlog dump command on a cluster endpoint.

    • Fixed incorrect request routing for multi-statement queries using temporary tables.

    • Fixed a compatibility issue with read-only endpoints using connection-based load balancing in certain scenarios.

    • Fixed an issue where the transaction-level connection pool was not correctly reused in COM_RESET_CONNECTION scenarios.

    • Fixed an issue where requests were unexpectedly routed to the primary database under global consistency.

    • Fixed a potential connection leak in the proxy caused by frequent use of the KILL CONNECTION command.

    • Fixed an issue that could cause connection blocking in certain scenarios.

  • 2.8.35 (Release date: 2024-02-26)

    Category

    Description

    New features & performance optimizations

    Bug fixes

    • Fixed a disconnection issue with binlog_dump when BINLOG_DUMP_NON_BLOCK is enabled.

    • Fixed an issue where automatic traffic redirection blocked some database connections for extended periods in certain scenarios.

    • Fixed a potential error when using SET OPTION with the session-level connection pool.

    • Fixed an issue that could cause connection blocking in certain scenarios when using STMT_SEND_LONG_DATA.

    • Fixed an issue where some persistent connections failed to exit as expected.

    • Fixed an issue where some monitoring metrics were inaccurate in certain scenarios.

    • Fixed an issue that caused exceptions on some proxy nodes.

  • 2.8.28 (Release date: 2024-01-08)

    Category

    Description

    New features & performance optimizations

    • Automatic traffic redirection now supports intra-transaction traffic distribution for a cluster endpoint when its Read-write mode is set to Read-only and its Load balancing policy is set to Active Request-based Load Balancing.

    • In automatic traffic redirection mode, deleting an AP node now affects existing connections.

    • You can now configure server weights at the endpoint level.

    • Optimized persistent connections in some scenarios.

    • SSL now supports only TLS 1.2.

    Bug fixes

    • Fixed an issue that caused clients to receive error code 9000 when using automatic traffic redirection with PolarDB for MySQL 8.0.2.

    • Fixed an issue where clients received error code 9000 for SQL statements with special syntax during automatic traffic redirection.

    • Fixed an issue where the EXPLAIN SELECT operation failed in some scenarios.

    • Fixed an issue where deleting a read-only node briefly blocked user requests in some scenarios.

    • Fixed an issue where connections could become unresponsive in some scenarios when using a transaction-level connection pool.

    • Fixed an issue that caused exceptions on some proxy nodes.

    • Fixed proxy exceptions and unresponsive connections that occurred in some scenarios when using automatic traffic redirection with a cluster endpoint's Consistency level set to Session consistency or Global consistency.

    • Fixed a routing error caused by temporary tables in SQL statements.

  • 2.8.25 (Release date: 2023-08-30)

    Category

    Description

    New features & performance optimizations

    Optimized persistent connections.

    Bug fixes

    • Fixed an issue where internal keep-alive messages or large packets could cause user sessions to hang.

    • Fixed an issue that incorrectly routed SELECT statements with custom variables to the primary database.

    • Fixed an issue that incorrectly routed multi-statement queries with comments to read-only nodes.

  • 2.8.24 (Release date: 2023-08-08)

    Category

    Description

    New features and performance optimizations

    Optimized the internal monitor's detection template.

    Bug fixes

    • Fixed an issue where show warnings timed out and failed on a read-only endpoint.

    • Fixed a PolarProxy exception that could occur when the transaction-level connection pool was enabled.

  • 2.8.21 (Release date: 2023-06-25)

    Category

    Description

    New features and performance optimizations

    • Optimized the performance of some internal modules.

    • Added support for routing explain select statements to read-only nodes.

    • Added support for routing show status statements to the previous node.

    • Added support for query encryption.

    Bug fixes

    • Fixed an issue that could cause a session to hang if an AP node was restarted while automatic request distribution for row and column stores was enabled.

    • Fixed an issue that could cause a session to hang if a node was restarted while parallel query was enabled.

    • Fixed an issue that incorrectly routed Optimize statements to a read-only node.

    • Fixed parsing errors in with select statements that incorrectly routed requests to the primary node.

    • Fixed an issue where the polar_proxy_encode database was unexpectedly visible to users.

    • Fixed response time (RT) jitter when adding a read-only node.

    • Fixed an issue that prevented dynamic data masking from taking effect.

    • Fixed exceptions on some database proxy nodes.

  • 2.8.12 (Release date: 2023-03-01)

    Category

    Description

    New features and performance optimizations

    Improved the performance of short-lived connections by 10%.

    Bug fixes

    • Fixed an issue where row_number was incorrectly routed to the primary node.

    • Fixed several database proxy exceptions.

    • Fixed an issue where exceptions on read-only nodes caused PolarProxy monitoring failures and user disconnections.

    • Fixed an issue where using prepare exec failed when automatic request distribution for row stores was enabled.

    • Fixed an issue that prevented dynamic data masking from taking effect.

  • 2.8.11 (Release date: 2023-02-22)

    Category

    Description

    New features and performance optimizations

    Automatic request distribution for row and column stores now supports transactions, session consistency, and global consistency.

    Bug fixes

    • Fixed a routing error for SQL statements that contain temporary tables and are longer than 64 KB.

    • Fixed a loss of transaction state during transaction splitting that caused transient disconnections for PHP 8.0 clients.

    • Fixed authentication failures on read-only endpoints.

    • Fixed connection establishment failures when using the session-level connection pool.

  • 2.8.8 (Release date: 2022-12-15)

    Category

    Description

    New features and performance optimizations

    • Read/write splitting now supports weight-based dynamic load balancing. For more information, see Weight-based dynamic load balancing.

    • Read-only endpoints now support request-level load balancing.

    • In HTAP scenarios, automatic request distribution for row and column stores now supports routing transactional processing (TP) requests to AP nodes.

    • Changes to the Elastic Parallel Processing (EPP) setting now take effect on existing connections.

    Bug fixes

    Fixed an issue that caused connections to be terminated.

  • 2.8.3 (Release date: 2022-11-04)

    Category

    Description

    New features and performance optimizations

    • Added support for overload protection.

    • Added support for readable hot replicas.

    Bug fixes

    • Fixed unexpected disconnections in multi-statement queries when using automatic request distribution for row and column stores in HTAP scenarios.

    • Fixed several internal exceptions that caused RT jitter.

  • 2.7.9 (Release date: 2022-08-01)

    Category

    Description

    New features and performance optimizations

    Bug fixes

    • Fixed inconsistent states in the session-level connection pool caused by the loss of environment variables on newly added database nodes.

    • Fixed an incorrect routing issue for update statements when a read-only transaction was enabled in a multi-statement scenario.

    • Fixed an incorrect routing issue for COM_STMT_FETCH in consistency-first scenarios.

  • 2.7.5 (Release date: 2022-07-15)

    Category

    Description

    New features and performance optimizations

    • The SQL firewall feature now supports show syntax.

    • Added support for read/write cluster endpoints.

    Bug fixes

    • Fixed an issue where the Accept Reads on Primary Node setting did not apply to existing connections.

    • Fixed several internal exceptions.

  • 2.4.35 (Release date: 2022-07-05)

    Category

    Description

    Bug fixes

    • Fixed a session exception caused by receiving a SET request during a primary node restart when persistent connections were enabled.

    • Fixed inaccuracies in internal monitoring and diagnostic tools.

  • 2.4.33 (Release date: 2022-05-07)

    Category

    Description

    Bug fixes

    • Fixed incorrect connection reuse in the transaction-level connection pool caused by a failure to replay environment variables.

    • Fixed an issue where an error occurred when the HTAP automatic load executed prepare exec.

    • Fixed an issue where transaction splitting caused the loss of transaction state in the packet status, which could affect PHP 8.0 clients.

    • Fixed several database proxy exceptions.

  • 2.4.30 (Release date: 2022-03-08)

    Category

    Description

    New features and performance optimizations

    Optimized the session consistency level.

    Bug fixes

    • Fixed incorrect routing issues for the HTAP automatic request distribution feature.

    • Fixed a database proxy exception on instances with more than 32 cores.

    • Fixed potential database proxy crashes.

    • Fixed an incorrect routing issue with prepare select for update.

  • 2.4.27 (Release date: 2021-12-30)

    Category

    Description

    New features and performance optimizations

    Added support for automatic request distribution for row and column stores.

    Bug fixes

    • Fixed an issue where kill session failed.

    • Fixed an issue where COM_STMT_EXECUTE failed when parameter types were frequently modified.

    • Fixed an issue where read requests were incorrectly routed to a read-only node after Select for update was executed within a transaction.

    • Fixed an issue where new connections created during a primary node restart failed to insert special utf8mb4 characters.

    • Fixed a session consistency issue that prevented reading the latest committed data after a transaction was committed.

  • 2.4.22 (Release date: 2021-09-10)

    Category

    Description

    Bug fixes

    • Fixed high database memory usage caused by the database proxy failing to close prepared statements.

    • Fixed persistent connection failures.

    • Fixed a database proxy exception that occurred when changing the default cluster endpoint to read-only mode.

    • Fixed potential database proxy crashes.

  • 2.4.18 (Release date: 2021-08-12)

    Category

    Description

    Bug fixes

    • Fixed garbled text in JDBC applications that did not specify a character set during database node restarts or account authentication failures.

    • Fixed connection failures for Flink clients.

    • Fixed routing errors for some temporary tables.

  • 2.4.17 (Release date: 2021-07-14)

    Category

    Description

    New features and performance optimizations

    • PolarDB for MySQL 5.7 now supports persistent connections for transactions in failover scenarios.

    • Added internal monitoring metrics.

    Bug fixes

    • Reduced long response times during MySQL account authentication failures.

    • Optimized connection establishment to quickly bypass an abnormal read-only node.

    • Fixed connection failures when parallel query was enabled on a read-only endpoint.

    • Fixed a routing error for current timestamp.

    • Fixed an incorrect parsing and routing issue for for update statements.

    • Fixed a routing error caused by incorrectly parsing @a in a join clause.

    • Fixed authentication failures for MySQL 8.0 clients that used an empty password.

    • Fixed execution failures for some named prepare statements.

  • 2.4.12 (Release date: 2021-05-20)

    Category

    Description

    New features and performance optimizations

    Added support for dynamic data masking.

    Bug fixes

    Fixed several database proxy exceptions.

  • 2.4.7 (Release date: 2021-03-15)

    Category

    Description

    New features and performance optimizations

    Added support for persistent connections.

    Bug fixes

    Fixed an incorrect routing issue for lock in shared mode.

PolarProxy 1.x.x release notes

Note

The following list includes only the mainstream versions of PolarProxy. Your version number may not be in this list.

  • 1.13.42 (Release date: 2022-12-15)

    Category

    Description

    Bug fixes

    • Fixed connection failures caused by an excessive number of database connections.

    • Fixed response time (RT) jitter caused by internal scheduled tasks.

  • 1.13.39 (Release date: 2022-07-20)

    Category

    Description

    New features & performance optimizations

    • Improved PolarProxy performance when handling high volumes of failed authentications.

    • Optimized the account authentication feature. Changed the rate limiting granularity for failed account authentications from global to account-level.

    Bug fixes

    • Fixed an issue where transaction state was lost during transaction splitting.

    • Fixed an issue where environment variables were not replayed in the transaction-level connection pool.

    • Fixed an issue where prepared statements failed to close in XA transactions.

    • Fixed several internal exceptions.

  • 1.13.34 (Release date: 2022-03-03)

    Category

    Description

    New features & performance optimizations

    • Added support for the MySQL utf8mb3 encoding format.

    • Improved session consistency.

    Bug fixes

    Fixed incorrect routing of select for update statements caused by a large number of prepared statement parameters.

  • 1.13.30 (Release date: 2021-12-30)

    Category

    Description

    Bug fixes

    Fixed an issue that prevented reading the latest committed data after a transaction with session consistency had committed.

  • 1.13.27 (Release date: 2021-11-16)

    Category

    Description

    Bug fixes

    • Fixed SSL compatibility issues with some clients.

    • Optimized the proxy's parsing performance for insert statements.

  • 1.13.25 (Release date: 2021-08-18)

    Category

    Description

    Bug fixes

    • Fixed a proxy memory leak caused by MySQL account authentication failures.

    • Fixed a proxy crash in multi-endpoint scenarios.

  • 1.13.22 (Release date: 2021-07-21)

    Category

    Description

    New features & performance optimizations

    • Added support for select last_insert_id() when the transaction-level connection pool is enabled.

    • Added support for the FOUND_ROWS() function when the transaction-level connection pool is enabled.

    • Added support for routing the COM_STATISTICS protocol to read-only nodes.

    • Optimized the transaction-level connection pool.

    • Optimized global consistency. Requests can be routed to a read-only node if at least one read-only node meets the consistency requirements.

    • Added support for routing geo functions to read-only nodes.

    • Added internal monitoring metrics.

    Bug fixes

    • Fixed routing errors caused by incorrect parsing of some SQL statements.

    • Fixed an issue where stmt_exec() failed after stmt_long_data() was executed in specific scenarios.

    • Fixed an issue where the load data infile command failed.

  • 1.13.5 (Release date: 2020-12-01)

    Category

    Description

    New features & performance optimizations

    • Eventual consistency now supports transaction splitting.

    • Added support for the following HINT syntax:

      • force node connection /*force_proxy_internal*/set force_node = 'pi-aaaaaaaaa';

        All subsequent requests on this connection are sent only to the node pi-aaaaaaaaa. If this node is unhealthy, PolarProxy returns the error message set force node 'pi-aaaaaaaaa' is not found, please check..

      • force node query /*force_node='pi-aaaaaaaa'*/ show processlist;

        This request is executed only on the pi-aaaaaaaa node. If this node is unhealthy, PolarProxy returns the error message 'force hint server node is not found, please check.'.

    • Added internal monitoring metrics.

    Bug fixes

    • Fixed an issue where the select type, status, mode, where gtx_id = '4' FOR UPDATE; statement was routed to a read-only node because it contained the mode keyword.

    • Fixed a load imbalance issue under specific conditions.

    • Fixed an issue that could cause stmt_close to fail in prepare scenarios.

  • 1.12.10 (Release date: 2020-10-19)

    Category

    Description

    Bug fixes

    • Fixed connection failures for MySQL 8.0 when using SSL encryption.

    • Fixed an issue where PolarProxy failed to handle new requests to a database node after its status changed from DOWN to RUNNING.

  • 1.12.7 (Release date: 2020-08-06)

    Category

    Description

    New features & performance optimizations

    • Added support for show full processlist syntax.

    • Added support for XA transaction syntax.

    Bug fixes

    • Fixed several issues with the transaction-level connection pool.

    • Fixed issues with accessing read-only nodes in a Global Database Network (GDN).

    • Fixed an error when executing the show processlist command in MySQL 8.0.

    • Fixed several connection establishment failures.

  • 1.11.12 (Release date: 2020-06-22)

    Category

    Description

    New features & performance optimizations

    • Added support for the transaction-level connection pool.

    • PolarDB for MySQL 8.0 read-only endpoints now support parallel query.

  • 1.10.7 (Release date: 2020-03-18)

    Category

    Description

    New features & performance optimizations

    Added support for global consistency.

    Bug fixes

    Fixed an exception when initializing system environment variables in the session-level connection pool.

  • 1.9.23 (Release date: 2020-02-21)

    Category

    Description

    New features & performance optimizations

    • Added support for connecting to a cluster by using the root account.

    • Added support for SSL encryption.

    Bug fixes

    • Fixed an issue where the change user command failed.

    • Fixed an issue where the load file command failed.

    • Fixed an issue that caused applications to report an Exception: Packets out of order error after receiving a packet with an incorrect sequence.

    • Fixed an issue that caused read-only endpoints to disconnect when the primary node became unavailable.

  • 1.9.14 (Release date: 2019-12-24)

    Category

    Description

    New features & performance optimizations

    • Added support for HINT syntax, such as /*FORCE_SLAVE*/ and /*FORCE_MASTER*/.

    • The primary database can now accept read requests.

    Bug fixes

    • Fixed garbled characters caused by an incorrect default charset value.

    • Fixed an issue where an incorrect MySQL version string was returned.

Upgrade version

Upgrade the database proxy if it is not the latest version. For detailed instructions, see Manual upgrade.