Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[4.5.0] - 2026-10-13

🪄 Added

• Added opt-in tenant-aware caching to the Remote Query Cache Plugin through cacheEnableDatabaseMultiTenancy. When enabled, supported PostgreSQL role and search_path state, or MySQL/MariaDB account, role, and database state, are incorporated into cache keys to reduce cross-tenant cache collisions. This provides best-effort hardening, not a guaranteed tenant-isolation boundary (PR #2140, documentation).

🐛 Fixed

• Fixed plain Statement reads not being balanced under queryLevelLoadBalancing, so both Statement and PreparedStatement reads now honor a reader rotation (PR #2139, documentation).
• Fixed read/write roles not being verified for host lists supplied in the connection string; a host whose actual role disagrees with the connection string is now corrected in the host list and reported, so reader and writer selection use the verified role (PR #2137, documentation).
• Fixed defects found by a full architecture review, including the Data Local Cache Plugin being unbounded in both staleness and size (it is now bounded by dataCacheTtlMs and dataCacheMaxSize, which reject negative values), the KMS encryption annotation being documented as stripped from the statement when it is in fact sent to the database and visible in server-side query logs, the differing abort deadlines of efm and efm2, and the weightedRandom and highestWeight selectors being applied to an Aurora topology where weight records load rather than preference (PR #2136, documentation).
• Fixed the AWS Secrets Manager plugin building a new Secrets Manager client for every connect retry; the client is now reused across the retries of a connection attempt (PR #2130, documentation).
• Fixed PostgreSQL target datasource settings not being applied to an XA connection on Java 24 (PR #2129, documentation).
• Fixed the Blue/Green plugin staying pinned to a deleted deployment; its collected state is now discarded and the new green endpoint rediscovered without restarting the application, and an unreachable green environment is now reported at WARNING instead of only at FINEST (PR #2117, documentation).
• Fixed refreshed host measurements not being published to the load-aware host selectors, which left lowestLoad and the other load-based strategies selecting on stale CPU and replica lag values (PR #2115, documentation).

🦀 Changed

• Improved Remote Query Cache Plugin safety when cacheEnableDatabaseMultiTenancy is enabled. Recognized session-state operations and user-defined variable references now disable caching for the connection, while certain session-dependent queries bypass the cache for that query only (PR #2160, documentation).
• Completed the Javadoc tags that produced doclint warnings and repaired a broken Javadoc reference that was failing the snapshot build (PR #2104, PR #2135).
• Dependency updates, including Hibernate ORM 7.4.11.Final, Jackson Databind (2.22.3 and 3.2.3), Jackson JSR-310 2.22.3, Kotlin stdlib 2.4.20, slf4j-simple 2.0.20, Narayana JTA 5.12.7.Final, c3p0 0.14.2, jsoup 1.23.2, Vert.x 4.5.34, and various GitHub Actions bumps (PR #2105, PR #2106, PR #2107, PR #2112, PR #2113, PR #2114, PR #2120, PR #2121, PR #2122, PR #2123, PR #2124, PR #2125, PR #2132, PR #2133, PR #2134, PR #2143, PR #2144, PR #2150, PR #2151, PR #2152, PR #2153, PR #2154, PR #2156).
• CI and test improvements: fixed the Java 17+ integration test classpath and the CI IP cleanup, used driver properties for the test topology connection, raised the in-container test heap to avoid a MariaDB Blue/Green out-of-memory failure, retried an Aurora failover that the RDS API reverts, and stopped leaking RDS parameter groups (PR #2118, PR #2119, PR #2128, PR #2147, PR #2148).
• Documentation:
  • added an "Available Since Version" column to the parameter tables (PR #2131, documentation)
  • documented the topology-monitoring- property prefix and the credentials a shared clusterId also shares (PR #2116, documentation)
  • corrected the MariaDB pipelining guidance for Connector/J 3.x (PR #2145, documentation)
  • added notes explaining the compatibility tables (PR #2142, documentation)
  • clarified the Remote Query Cache Plugin guidance (PR #2138, documentation)
  • refreshed the project landing page (PR #2141, documentation).