These are the release notes for the PolarDB-X change data capture (CDC) node.
Release date: 2026-05-21
Product version: V2.5.0
Component version: 5.4.21
|
Category |
Description |
|
Fix |
Fixed a circular dependency issue during CDC BinlogX Relay Log cleanup. |
Release date: 2026-05-13
Product version: V2.5.0
Component version: 5.4.21
|
Category |
Description |
|
Enhancement |
Fixed exceptions that occurred during asynchronous DDL synchronization. |
|
Fix |
Fixed an issue where the binlog dump could hang after a CDC version upgrade and a binlog rebuild. |
Release date: 2026-04-14
Product Version: V2.5.0
Component Version: 5.4.21
|
Category |
Description |
|
Fixed |
Fixed an issue where certain invalid table creation statements caused Binlog to generate incorrect SQL. |
Release date: 2026-03-12
Product version: V2.5.0
Component version: 5.4.21
|
Category |
Description |
|
Enhancements |
Metadata persistence is now automatically enabled for low memory configurations. |
|
Fixed an issue where a replica could not synchronize empty string values for non-NULL JSON fields. |
|
|
Fixes |
Fixed an issue where multiple |
|
Fixed an issue where a log node would occasionally report an error when retrieving the METADB address. |
Release date: 2026-01-27
Product version: V2.5.0
Component version: 5.4.21
|
Category |
Description |
|
New features and enhancements |
Upgraded CDC (log node) to version 5.4.21. |
|
The CDC (log node) now supports the new DN query event variable |
|
|
Introduced support for Binlog compression. |
|
|
Improved the data synchronization performance of the columnar store index (CCI). |
|
|
Optimized the recovery speed of the CDC (log node) when a storage node (DN) undergoes a specification change. |
|
|
Fixes |
Fixed an error that occurred when downstream data synchronization tools, such as Flink CDC, parsed Binlog events of the |
|
Fixed an error in the columnar store index (CCI) when it parsed DDL statements containing the comment character |
|
|
Fixed an occasional error in the Binlog consumption pipeline that occurred during high-rate Binlog generation. |
|
|
Fixed intermittent connection interruptions to downstream PolarDB-X instances caused by source-side filtering on the CDC (log node). |
|
|
Fixed a JVM crash caused by frequent garbage collection (GC) when the CDC (log node) runs on extra-large instances. |
|
|
Fixed interruptions to the CDC (log node) main link that occurred during |
Release date: 2025-10-11
Product version: V2.5.0
Component version: 5.4.20
|
Category |
Description |
|
New features |
Binlog Dump now filters out delete events from archived tables when generating a Binlog. |
Release date: 2025-09-15
Product version: V2.5.0
Component version: 5.4.20
|
Category |
Description |
|
Enhancements |
Introduced the virtual table feature to map multiple qualifying physical tables to a single virtual table using mapping rules. |
|
Added the |
|
|
Optimized data synchronization from binlog to the CCI. |
|
|
Fixes |
Fixed a potential OOM error on the CDC log node, triggered by an oversized binlog event 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 feature improves data management by letting you adapt the CCI's data distribution and sorting strategy to business changes, which optimizes query performance without requiring an index rebuild. |
|
Added support for the in-place rebuilding of a clustered columnstore index (CCI). This operation lets you optimize and reorganize a CCI with no impact on active queries or access to historical data. |
|
|
Fixed issues |
Fixed an issue where a data node (DN) could interrupt the data stream when using 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 out delete events from archived tables when generating binary logs. |
Release date: 2025-03-28
Product version: V2.5.0
Component version: 5.4.20
|
Category |
Description |
|
New feature |
CDC (CDC nodes): Multi-stream binary logs now support a one-to-one mapping between a storage node and a binary log stream. |
|
Feature optimizations |
Optimized memory management for dump operations on binary logs. |
|
Increased the output rate of binary logs from CDC nodes to downstream systems. |
|
|
Reduced the load on the global meta service (GMS) by optimizing SQL statements from CDC nodes. |
Release date: 2025-03-05
Product version: V2.4.0
Component version: 5.4.19
|
Category |
Description |
|
New feature |
Change Data Capture (CDC): The multi-stream binary log on log nodes now supports a one-to-one mapping between a storage node and a binary log 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 constraints. For details, see CHECK constraints. |
|
Optimized the allocation policy for CDC off-heap direct memory to prevent OOM from insufficient direct memory allocation. |
|
|
Optimized the forced restart mechanism for CDC timeouts to allow restarts even when the CDC worker process is blocked. |
Release date: 2024-11-22
Product version: V2.5.0
Component version: 5.4.20
|
Category |
Description |
|
Improvements |
Increased the default size of a single binary log file to 1 GB and enabled automatic rotation when the file number exceeds 999,999. |
|
Improved 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 an upgrade from an earlier CDC version would be interrupted because of a missing |
|
Fixed an issue where the |
Release date: 2024-09-28
Product version: V2.4.0
Component version: 5.4.19
|
Category |
Description |
|
Fix |
Fixed a bug causing CDC link interruptions due to compatibility issues when processing |
Release date: 2024-09-13
Product version: V2.4.0
Component version: 5.4.19
|
Category |
Description |
|
Fixes |
Fixed an issue where a single SQL statement updating multiple tables generated consecutive TableMapEvents, resulting in disordered TraceIDs. |
Release date: 2024-09-06
Product version: V2.4.0
Component version: 5.4.19
|
Category |
Description |
|
Fixes |
Fixed an issue where the CDC process failed to start when a single compute node was unavailable. |
|
Fixed an issue where dump operations failed due to inconsistent offsets between memory and a binary log file. |
Release date: 2024-08-28
Product Version: V2.4.0
Component Version: 5.4.19
|
Category |
Description |
|
Fixes |
Fixed an issue where the |
|
Fixed an issue where a binary log file was lost during CDC topology reconstruction due to concurrent uploads of the same file. |
|
|
Fixed issues where the SQL parser failed to parse |
|
|
Fixed an issue where the replication link could not recover automatically. This failure was caused when the system deleted local files on the master node during CDC Dumper primary-secondary synchronization. |
Release Date: 2024-08-02
Product Version: V2.4.0
Component Version: 5.4.19
|
Category |
Description |
|
New feature |
Enabled CDC (change data capture) nodes to periodically build sync points. |
|
Fixed issue |
Fixed an issue where a binary log cursor update failure blocked data consumption. |
Release date: 2024-07-10
Product version: V2.4.0
Component version: 5.4.19
|
Category |
Description |
|
New features and optimizations |
Enabled CDC nodes to periodically build |
|
Improved full data validation in the upgrade assessment from PolarDB-X 1.0 to PolarDB-X 2.0. |
|
|
Fixes |
Fixed global binary log generation failures caused by metadata changes. |
|
Fixed binary log dump service failures caused by empty requested binary log files. |
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 replicates functions. |
|
Primary/secondary DDL replication now replicates sequences. |
|
|
Primary/secondary DDL replication now replicates views. |
|
|
Primary/secondary DDL replication now replicates procedures. |
|
|
Primary/secondary DDL replication now replicates accounts, roles, and permissions. |
|
|
Primary/secondary DDL replication now replicates ALTER TABLEGROUP operations. |
|
|
Primary/secondary DDL replication now replicates ALTER INDEX operations. |
|
|
Primary/secondary DDL replication now supports consistency-coordinated and aligned replication in multi-stream binary log scenarios. |
|
|
Primary/secondary replication now enables you to create a replication link based on a timestamp. |
|
|
Primary/secondary replication now enables you to use SQL commands to verify data consistency between upstream and downstream systems. |
|
|
A new secondary instance role for primary/secondary replication is now available, enabling instance-level read-only capabilities on the secondary cluster. |
|
|
Primary/secondary replication now supports full mirror matching of WHERE conditions for DML writes. |
|
|
You can now bind multi-stream binary log stream names to user names. This eliminates the need to add the 'with' option when executing binary log-related SQL statements with a bound account. |
|
|
Optimized server_id-based bidirectional replication for primary/secondary replication. You can now specify filter rules from the command line, and the system now automatically checks for server_id anomalies. |
|
|
Fixes |
Fixed an issue where the MULTI ALTER ADD/DROP COLUMN statement caused an incorrect metadata column order, which interrupted the binary log link. |
|
Fixed an issue where the MULTI ALTER ADD/DROP/RENAME INDEX statement could cause index metadata to be lost, which resulted in an incorrect DDL statement being recorded in the binary log. |
|
|
Fixed a configuration defect in the meta_build_physical_ddl_sql_blacklist_regex parameter that caused ALTER DDL statements to be filtered if they contained the 'user' keyword. |
|
|
Fixed an issue where DROP INDEX DDL statements were not written to the binary log. |
Release date: 2024-03-22
Version number: polarx-cdc-kernel-2.3.0_5327694
|
Category |
Description |
|
New feature |
Added binlog-related O&M commands, such as |
|
Fixed issue |
Fixed an issue where exact matching failed in SQL flashback. |
Release date: 2024-02-04
Version number: polarx-cdc-kernel-2.3.0_5169624
|
Category |
Description |
|
New feature |
Added the |
|
Feature optimization |
Improved MySQL binlog dump compatibility to support parameters such as checksum and heartbeat. |
Release date: 2023-12-21
Version number: polarx-cdc-kernel-2.3.0_4988569
|
Category |
Description |
|
New feature |
Adds support for SQL flashback to roll back an entire transaction. |
|
Fixed issue |
Fixed the recording method for TSO heartbeats in the binary log to resolve crashes in downstream MySQL consumers. |
Release date: 2023-10-23
Version number: polarx-cdc-kernel-2.3.0_4825080
|
Category |
Description |
|
Optimization |
Optimized the sleep time for gRPC backpressure control, boosting the external binlog dump speed to 130 MB/s. |
|
Fixes |
Fixed an issue that prevented SQL flashback from finishing 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 |
|
Optimization |
Optimized the |
|
Fixes |
Fixed a buffer overflow when shaping JSON data. |
|
Prevented the metaDataSource scan thread from exiting during an HA switchover in metaDB during a CDC upgrade. |
|
|
Fixed a deadlock 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 |
|
Optimized the speed of external dumps for transparent consumption. |
|
|
CDC no longer depends on |
|
|
Removed the control dependency for retrieving a MetaDB connection in CDC. |
|
|
Fixes |
Fixed a syntax error in table creation statements with a |
|
Fixed an issue where the |
|
|
Fixed an issue where a task dump failed to find the starting offset on the primary instance DN after a read-only instance was scaled. |
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 |
Fixed an issue where |
|
Fixed a bug where the gRPC thread failed to exit when local files on the Dumper Master were 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 link error caused by a heartbeat window conflict when consuming a binary log from OSS. |
|
Fixed a data format conversion error when shaping a |
|
|
Fixed a |
|
|
Fixed inconsistent metadata between logical and physical tables for |
|
|
Fixed an issue that prevented DDL SQL statements with line feeds from being converted to single-line comments. |
Release date: 2023-05-09
Version number: polarx-cdc-kernel-2.0.1-4292946
|
Category |
Description |
|
New features and optimizations |
Added support for monitoring the CPU utilization of the worker process. |
|
Added support for more fine-grained monitoring of Events Per Second (EPS) for |
|
|
Optimized the upload speed of binary log files to Object Storage Service (OSS), increasing the rate to 700 MB/s. |
|
|
Added Operations and Maintenance (O&M) commands for Change Data Capture (CDC), such as |
|
|
Fixes |
Fixed long blocking during the transparent consumption of offline binary log files. |
|
Fixed an issue where the dump thread would fail to exit if a binary log file was deleted while being read. |
|
|
Fixed |
|
|
Fixed an inconsistency between the |
|
|
Fixed a downstream MySQL error caused by an SQL statement containing both |
Release date: 2023-04-28
version number: polarx-cdc-kernel-2.0.0-4273008
|
Category |
Description |
|
Fixes |
Fixed an issue where the column order was incorrect after an SQL statement was executed in the SchemaRepository. |
|
Fixed an NPE triggered when data shaping an empty string. |
Release date: 2023-04-07
Version: polarx-cdc-kernel-2.0.0-4206104
|
Category |
Description |
|
Fix |
Fixed an issue where metadata was truncated when it exceeded the length of the |
Release date: 2023-03-29
Version number: polarx-cdc-kernel-2.0.0-4180250
|
Category |
Description |
|
Bug fix |
Fixed a parsing failure caused by the MySQL charset not being converted to the Java charset. |
Release date: 2023-03-22
Version number: polarx-cdc-kernel-2.0.0-4148671
|
Category |
Description |
|
Feature optimizations |
Reduced the RTO of the binary log synchronization link to 15 seconds. |
|
Accelerated CDC metadata recovery for deployments with 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 CDC link interruptions caused by the continuous addition and deletion of primary keys. |
|
Fixed a CDC disconnection that occurred when the consumer program failed to send COM_REGISTER_SLAVE before dumping binary logs. |
|
|
Fixed a data link interruption in 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 |
Adds support for multi-level merging. This ensures performance does not significantly decrease as DN nodes scale linearly. |
|
Adds support for transparent consumption. Downstream consumer programs can use the dump protocol to directly consume binary log files archived to OSS without needing to interface with OSS directly. |
|
|
Adds support for multi-stream binary log. You can customize the number of streams, each with its own independent binary log file. |
|
|
Adds support for periodically building full metadata snapshots. This prevents historical DDL tagging records from growing excessively. |
|
|
Adds support for downloading binary log files from OSS in parallel to improve instance recovery speed. |
|
|
Fixes |
Fixed compatibility and correctness issues in shaping binary log event data, improving the stability of the CDC link during DDL changes. |
|
Fixed an issue that could cause dump timeouts for downstream subscriptions after a CDC cluster restart. |
|
|
Fixed an incorrect latency calculation that occurred during the initial startup of the Dumper process. |