This topic provides the release notes for the PolarDB-X change data capture (CDC) node.
Release date: 2026-01-27
Product version: V2.5.0
Component version: 5.4.21
Category | Description |
New features and enhancements | Upgraded the CDC (log node) to version 5.4.21. |
CDC (log node) adds support for a new DN query event variable, | |
Added support for binlog compression. | |
Improved data synchronization performance for columnar indexes (CCI). | |
Accelerated the recovery of the CDC (log node) after a storage node (DN) is resized. | |
Bug fixes | Fixed an issue that could cause an exception in downstream data synchronization tools, such as Flink CDC, when parsing binlog events of the |
Fixed an issue where columnar index (CCI) reported an error when parsing DDL statements that contain the comment character | |
Fixed a bug that caused occasional errors in the binlog consumption pipeline when binlogs were generated at a high rate. | |
Fixed a bug where enabling the source-side filtering feature in the CDC (log node) occasionally interrupted connections to downstream PolarDB-X instances. | |
Fixed a bug that occasionally caused JVM crashes due to frequent GC (garbage collection) when the CDC (log node) was running on extra-large instances. | |
Fixed an issue where the primary CDC (log node) link might be interrupted when an |
Release date: 2025-10-11
Product version: V2.5.0
Component version: 5.4.20
Category | Description |
New feature | Adds active filtering for binary log dump to exclude delete events generated by archive tables during binary log creation. |
Release date: 2025-09-15
Product version: V2.5.0
Component version: 5.4.20
Category | Description |
New features and enhancements | Added support for virtual tables. You can now configure mapping rules to map multiple qualifying physical tables to a single virtual table. |
Added the | |
Improved performance when syncing data from binlogs to columnar store indexes (CCI). | |
Fixes | Fixed an issue where an excessively large binlog event could cause an OOM error in the CDC (log node) during binlog pipeline recovery. |
Release date: 2025-07-14
Product version: V2.5.0
Component version: 5.4.20
Category | Description |
New features | You can now modify the partition key and sort key of a clustered columnstore index (CCI). This allows you to adjust the data distribution and sorting strategy based on business changes, optimizing query performance without rebuilding the index. |
You can now perform in-place rebuilding of CCI to optimize and reorganize the index without affecting queries or access to historical data versions. | |
Fixes | A data node (DN) no longer causes data stream interruptions with the single-stream binary log service. |
Release date: 2025-06-19
Product version: V2.4.0
Component version: 5.4.19
Category | Description |
New feature | The CDC node now filters delete events from archive tables when producing binary logs. |
Release date: 2025-03-28
Product version: V2.5.0
Component version: 5.4.20
Category | Description |
New feature | Added support for a one-to-one mapping between a storage node and a binlog stream in multi-stream CDC configurations. |
Optimizations | Optimized memory management for the binlog dump operation. |
Increased the throughput of CDC nodes when streaming binlogs to downstream systems. | |
Optimized the SQL statements sent from CDC nodes to the global meta service (GMS) to reduce its load. |
Release date: 2025-03-05
Product version: V2.4.0
Component version: 5.4.19
Category | Description |
New feature | Multi-stream binlog: Now supports a one-to-one mapping between a storage node and a binlog stream. |
Release date: 2024-12-24
Product version: V2.5.0
Component version: 5.4.20
Category | Description |
New features and optimizations | Added support for CHECK constraint. |
Optimized the allocation policy for CDC off-heap direct memory to prevent out-of-memory (OOM) issues. | |
Optimized the CDC forced restart mechanism to trigger even when the worker process is blocked. |
Release date: 2024-11-22
Product version: V2.5.0
Component version: 5.4.20
Category | Description |
Enhancements | Increased the default size of a single binary log file to 1 GB and enabled automatic rotation when the binary log file sequence number exceeds 999,999. |
Optimized the download logic for transparently consumed binary log files. |
Release date: 2024-10-24
Product version: V2.5.0
Component version: 5.4.20
Category | Description |
Feature optimizations | Optimized the replication logic for primary and secondary nodes. |
Optimized the heartbeat timeout detection logic for the CDC high availability (HA) module to prevent unnecessary process restarts. | |
Fixes | Fixed an issue where upgrades from earlier CDC versions were interrupted due to a missing RuntimeVersion field in the system table configuration. |
The results of the |
Release date: 2024-09-28
product version: V2.4.0
component version: 5.4.19
Category | Description |
Fixed issue | Fixed an issue where CDC links were interrupted due to a compatibility difference in how CDC metadata handles |
Release date: 2024-09-13
Product version: V2.4.0
Component version: 5.4.19
Category | Description |
Fixed issue | Fixed a bug where a single SQL statement updating multiple tables would generate consecutive TableMapEvents, causing out-of-order TraceIDs. |
Release date: 2024-09-06
Product version: V2.4.0
Component version: 5.4.19
Category | Description |
Fixes | Fixed a CDC process startup failure caused by a single unavailable compute node. |
Fixed dump operation failures on a binary log file caused by an offset mismatch between memory and the file. |
Release date: 2024-08-28
Product version: V2.4.0
Component version: 5.4.19
Category | Description |
Fixes | Fixed an issue where executing the |
Prevented binlog file loss caused by concurrent uploads of the same file during CDC topology reconstruction. | |
Fixed an issue where the SQL parser failed to parse | |
Ensured automatic recovery of the replication link by preventing the deletion of local files on the master node during CDC Dumper primary-secondary synchronization. |
Release date: August 2, 2024
Product version: V2.4.0
Component version: 5.4.19
Category | Description |
New feature | CDC nodes can now periodically create sync points. |
Bug fix | Fixed a bug where the binary log cursor would not update as expected, blocking consumption. |
Release date: 2024-07-10
Product version: V2.4.0
Component version: 5.4.19
Category | Description |
New features and optimizations | Added support for Change Data Capture (CDC) nodes to periodically create |
Optimized full data validation for the upgrade assessment from PolarDB-X 1.0 to PolarDB-X 2.0. | |
Bug fixes | Fixed global binary log generation failures caused by metadata changes. |
Fixed a bug that caused the binary log dump service to fail when a requested binary log file was empty. |
Release date: 2024-04-16
Product version: V2.4.0
Component version: 5.4.19
Category | Description |
New features and optimizations | Primary/secondary DDL replication now supports replicating functions. |
Primary/secondary DDL replication now supports replicating sequences. | |
Primary/secondary DDL replication now supports replicating views. | |
Primary/secondary DDL replication now supports replicating procedures. | |
Primary/secondary DDL replication now supports replicating accounts, roles, and permissions. | |
Primary/secondary DDL replication now supports replicating | |
Primary/secondary DDL replication now supports replicating | |
Enhanced primary/secondary DDL replication to coordinate consistency across multiple binary log streams. | |
You can now create a primary/secondary replication link from a specific timestamp. | |
Added a SQL command to verify data consistency between upstream and downstream. | |
Introduced a secondary instance role. This role provides the secondary cluster with instance-level read-only capabilities. | |
Primary/secondary replication can now exactly match the | |
You can now bind multi-stream binary log stream names to usernames. This eliminates the need to specify the | |
Optimized | |
Fixes | Fixed an issue where |
Fixed an issue where | |
Fixed an issue where | |
|
Release date: 2024-03-22
Version number: polarx-cdc-kernel-2.3.0_5327694
Category | Description |
New feature | Added support for binary log-related O&M instructions, such as |
Fixed issue | Fixed SQL flashback failures in exact match mode. |
Release date: 2024-02-04
Version number: polarx-cdc-kernel-2.3.0_5169624
Category | Description |
New feature | Added the |
Feature optimization | Now supports parameters such as checksum and heartbeat for MySQL binary log dumping, improving compatibility. |
Release date: 2023-12-21
Version number: polarx-cdc-kernel-2.3.0_4988569
Category | Description |
New feature | Added support for SQL flashback to roll back an entire transaction. |
Fixed issue | Fixed an issue where the recording of TSO heartbeats in the binlog could cause downstream MySQL instances to crash. |
Release date: 2023-10-23
Version number: polarx-cdc-kernel-2.3.0_4825080
Category | Description |
Improvements | Optimized the sleep time for gRPC backpressure control, increasing the external binlog dump speed to 130 MB/s. |
Bug Fixes | Fixed an issue where sql flashback failed when no DML or DDL operations occurred within the specified time range. |
Release date: 2023-09-22
Version number: polarx-cdc-kernel-2.3.0_4755313
Category | Description |
Feature optimization | Improved the performance of the |
Fixes | Fixed a buffer overflow that occurred during JSON data processing. |
Fixed a bug that caused the metaDataSource scan thread to exit during a CDC upgrade due to an HA switchover in the metaDB. | |
Fixed a deadlock that occurred when updating |
Release date: 2023-08-18
Version number: polarx-cdc-kernel-2.3.0_4635493
Category | Description |
New features and optimizations | Added support for the FLUSH LOGS statement. |
Optimized the speed of external dumps for transparent consumption. | |
CDC no longer depends on is_vip to retrieve a DN connection. | |
CDC no longer depends on the control component to retrieve a MetaDB connection. | |
Fixes | Fixed a parsing error in table creation statements that included a BIGINT SIGNED column definition. |
Fixed gaps in the binary log list caused by the recover tso generation algorithm. | |
Fixed an issue that prevented Task dump from finding the starting offset on the primary instance DN after read-only instance scaling. |
Release date: 2023-07-06
Version number: polarx-cdc-kernel-2.3.0_4483662
Category | Description |
New feature | Added support for persisting transaction objects to reduce memory usage. |
Fixes | The |
gRPC threads now exit correctly even if local files on the Dumper Master are deleted during CDC Dumper primary-secondary synchronization. |
Release date: 2023-06-06
Version number: polarx-cdc-kernel-2.0.0-4273008
Category | Description |
Fixes | Fixed a heartbeat window conflict that could cause a link error when consuming binary logs from OSS. |
Fixed intermittent data format conversion errors during TableMapEvent processing. | |
Fixed an inconsistency between the | |
Fixed metadata inconsistency between logical and physical tables for | |
Fixed an issue that prevented a DDL statement containing a line feed from being converted into a single-line comment. |
Release date: 2023-05-09
Version number: polarx-cdc-kernel-2.0.1-4292946
Category | Description |
New features and optimizations | Added support for monitoring CPU utilization for worker processes. |
Added support for more fine-grained Events Per Second (EPS) monitoring for | |
Optimized binary log file uploads to OSS, reaching 700 MB/s. | |
Added Change Data Capture (CDC) operations and maintenance (O&M) commands, such as | |
Fixes | Fixed an issue where transparently consuming offline binary logs could cause prolonged blocking. |
Fixed an issue where the dump thread would fail to exit if a binary log file was deleted during a read operation. | |
Fixed an issue where | |
Fixed an issue where the | |
Fixed an issue where SQL statements containing both |
Release date: 2023-04-28
Version number: polarx-cdc-kernel-2.0.0-4273008
Category | Description |
Fixes | Fixed an issue that resulted in an incorrect column order in SchemaRepository after an SQL statement was executed. |
Fixed an issue where data shaping on an empty string triggered an NPE. |
Release date: 2023-04-07
Version number: polarx-cdc-kernel-2.0.0-4206104
Category | Description |
Fixed issue | Fixed a data truncation issue that was caused by metadata exceeding the length of the |
Release date: 2023-03-29
Version number: polarx-cdc-kernel-2.0.0-4180250
Category | Description |
Fixed issue | Fixed a parsing failure caused by MySQL charsets not being converted to their corresponding Java charsets. |
Release date: 2023-03-22
Version number: polarx-cdc-kernel-2.0.0-4148671
Category | Description |
Optimizations | Improved the recovery time for the binary log synchronization link, reducing the RTO to 15s. |
Improved CDC metadata recovery speed when scaling to hundreds of thousands of data tables. | |
Fixes | Fixed a potential offset calculation error when transparently consuming binary logs. |
Fixed a compatibility issue with |
Release date: 2023-02-06
Version number: polarx-cdc-kernel-2.0.0-3985896
Category | Description |
Fixes | Fixed an issue where the CDC link would be interrupted by consecutively adding and dropping a primary key. |
Fixed an issue where CDC would disconnect if the consumer program did not send COM_REGISTER_SLAVE before dumping the binary log. | |
Fixed data link interruptions during multi-stream data routing when the hash value was Integer.MIN_VALUE. |
Release date: 2023-02-01
Version number: polarx-cdc-kernel-2.0.0-3945546
Category | Description |
New features and optimizations | Supports multi-level merging. This prevents significant performance degradation when DN nodes are scaled out. |
Supports transparent consumption. Downstream consumers can use the dump protocol to consume binary log files from OSS without connecting to OSS directly. | |
Supports multi-stream binary logs. You can customize the number of streams, and each stream has its own independent log stream. | |
Supports periodically building full metadata snapshots. This prevents historical DDL tagging records from growing excessively. | |
Supports downloading binary log files from OSS in parallel to improve instance recovery speed. | |
Fixes | Fixed compatibility and correctness issues when shaping binary log event data, further improving the stability of the CDC link during DDL changes. |
Fixed an issue where a CDC cluster restart could cause a dump timeout for downstream subscriptions. | |
Fixed incorrect latency calculations during the initial startup of the Dumper process. |