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.
[3.0.0] - 2026-06-02
🦀 Breaking Changes
Warning
3.0.0 changes the default cluster_id behavior. Applications connecting to multiple database clusters must now explicitly set a unique cluster_id for each cluster. See the Cluster ID documentation for details.
Migration
| Scenario | Action Required |
|---|---|
| Single database cluster | No changes required |
| Multiple database clusters | Review all connection strings and add a unique cluster_id parameter per cluster. See the Cluster ID documentation for configuration guidance. |
🪄 Added
🐛 Fixed
- New pooled connections created with stale credentials, and PostgreSQL error handler unable to correctly handle auth errors nested in connection errors (PR #1231).
- Read/Write Splitting plugins not subscribed to the execute pipeline, causing idle connections to not be correctly closed during failover (PR #1117).
🦀 Changed
- Updated the default plugin list:
- Added the Aurora Initial Connection Strategy Plugin for both PostgreSQL and MySQL driver dialects.
- Removed the Host Monitoring Plugin V2 from the default plugins for MySQL driver dialect. Prior to this change, users need to manually remove it from the
pluginsconnection parameter.