Release Notes for Debezium 3.3

All notable changes for Debezium releases are documented in this file. Release numbers follow Semantic Versioning.

Release 3.3.0.Alpha2 (August 26th 2025)

Kafka compatibility

This release has been built against Kafka Connect 4.0.0 and has been tested with version 4.0.0 of the Kafka brokers. See the Kafka documentation for compatibility with other versions of Kafka brokers.

Upgrading

Before upgrading any connector, be sure to check the backward-incompatible changes that have been made since the release you were using.

When you decide to upgrade one of these connectors to 3.3.0.Alpha2 from any earlier versions, first check the migration notes for the version you’re using. Gracefully stop the running connector, remove the old plugin files, install the 3.3.0.Alpha2 plugin files, and restart the connector using the same configuration. Upon restart, the 3.3.0.Alpha2 connectors will continue where the previous connector left off. As one might expect, all change events previously written to Kafka by the old connector will not be modified.

If you are using our container images, then please do not forget to pull them fresh from Quay.io.

Breaking changes

There are no breaking changes in this release.

New features

  • Support for TSVECTOR data types for postgres Sink connector DBZ-8471

  • Improve error management and messages on Debezium Platform backend DBZ-8836

  • Add UI support for Fine-grained logging configuration DBZ-8890

  • Update tutorial to use KRaft mode DBZ-9184

  • Add support for MongoDB Source Connector to start CDC from a specified point DBZ-9240

  • Introduce timeout for ALTER/CREATE Publication statment DBZ-9310

  • Allow redo thread flush scn adjustment to be configurable DBZ-9344

  • Improve performance validation on whether a supplied value is a toast column DBZ-9345

  • SQL Server emits heartbeats while catching up DBZ-9364

  • Add detail pages to source and destination DBZ-9373

Fixes

  • Incremental snapshot offset failing to load on task restart DBZ-9209

  • Update kafka.version to 4.0.0 in parent pom DBZ-9300

  • Debezium Server Azure Event Hubs sink duplicates all previous events DBZ-9304

  • Archive log only mode does not pause mining when no more data available DBZ-9306

  • Mockit error in EventDispatcherTest DBZ-9332

  • Events may be mistakenly processed multiple times using multiple tasks DBZ-9338

  • Debezium constatly performs heartbeat.action.query instead of honoring heartbeat.interval.ms DBZ-9340

  • OCP tests fails to start DBZ-9342

  • Fetching transaction event count can result in NullPointerException DBZ-9349

  • Ensure JAVA_OPTS env var is correct on dbz server startup DBZ-9352

  • Issue in ReselectColumnsPostProcessor when field’s schema type is BYTES DBZ-9356

  • MariaDB fails to parse ALTER TABLE using RENAME COLUMN IF EXISTS syntax DBZ-9358

  • Oracle fails to reselect columns when table structure changes and throws ORA-01466 DBZ-9359

  • Single quotes getting double quotes in a create operation DBZ-9366

  • Mining upper boundary is miscalculated when using archive log only mode DBZ-9370

  • Proper Kafka producer exception not logged due to record.key serialisation error DBZ-9378

Other changes

  • Include XStream classes in downstream builds DBZ-8828

  • Remove any dummy value that are are using from showing them in UI DBZ-9106

  • Clarify IBM DB2 IIDR licensing requirement in Db2 connector documentation DBZ-9121

  • Document more restrictive configuration for creating Oracle LogMiner user DBZ-9129

  • Create rest resource for the connection DBZ-9313

  • Improve the Github Action that checks the commit messages DBZ-9327

  • Update assertj to 3.27.4 DBZ-9343

  • Add, remove, or convert Dev Preview and Tech Preview notes DBZ-9347

  • Add documentation for the LogMiner unbuffered mode DBZ-9351

Release 3.3.0.Alpha1 (August 5th 2025)

Kafka compatibility

This release has been built against Kafka Connect 4.0.0 and has been tested with version 4.0.0 of the Kafka brokers. See the Kafka documentation for compatibility with other versions of Kafka brokers.

Upgrading

Before upgrading any connector, be sure to check the backward-incompatible changes that have been made since the release you were using.

When you decide to upgrade one of these connectors to 3.3.0.Alpha1 from any earlier versions, first check the migration notes for the version you’re using. Gracefully stop the running connector, remove the old plugin files, install the 3.3.0.Alpha1 plugin files, and restart the connector using the same configuration. Upon restart, the 3.3.0.Alpha1 connectors will continue where the previous connector left off. As one might expect, all change events previously written to Kafka by the old connector will not be modified.

If you are using our container images, then please do not forget to pull them fresh from Quay.io.

Breaking changes

Deprecated names of snapshot modes were removed. Connector configuration must use new names (DBZ-8171).

New features

  • Execute Debezium in oracle readonly replica DBZ-8319

  • Support for TSVECTOR data types for postgres source connector DBZ-8470

  • Support MariaDB 11.7+ vector data type DBZ-8582

  • Fine-grained logging configuration DBZ-8638

  • During a mining session treat ORA-00310 redo logs being inconsistent DBZ-8870

  • Smart editor: Add the ability to create a complete pipeline directly using the debezium server configuration DBZ-8873

  • Smart editor: Provide support for an auto conversion between formats DBZ-8888

  • Add JMX metrics/statistics for cached events DBZ-8991

  • Introduce a way to restore the legacy numeric behavior with decimal.handling.mode DBZ-9166

  • Remove heartbeat creation from configuration in favor of HeartbeatFactory DBZ-9176

  • Simplify dockerfile for debezium-connector-vitess itests DBZ-9216

  • Update Outbox Extension to Quarkus 3.23.4 & Align to Hibernate 7.x DBZ-9219

  • Add Lightbox on website for images DBZ-9227

  • Azure Event Hub sink - built-in support for hashing partition keys DBZ-9245

  • Throw an exception on missing heartbeat table on Debezium-connector-postgres DBZ-9247

  • Add configuration to disable Context headers added with OpenLineage DBZ-9248

  • Add ability to specify whether to use a CTE-based query for LogMiner DBZ-9272

  • Allow Oracle heartbeat action query error handler to be resilient to ORA-02396 DBZ-9280

  • Uppdate Informix JDBC Driver to 4.50.12 DBZ-9288

  • Release CockroachDB connector DBZ-9289

  • Chart versioning must be SemVer compliant DBZ-8913

  • Add additional tag to images compliant with SemVer DBZ-8914

  • Debezium Engine Quarkus Extension: Support Heartbeat Event Listener DBZ-8960

  • Debezium Engine Quarkus Extension: custom deserializer DBZ-8962

  • Debezium Engine Quarkus Extension: introduce PostProcessor handler DBZ-8965

  • Debezium Engine Quarkus Extension: Add Support to Custom Converter DBZ-8966

  • Add EOS support into main Debezium connectors DBZ-9177

  • Avoid storing irrelevant DDL statements in history topic DBZ-9186

Fixes

  • User selection is not persistence in pipeline designer DBZ-8761

  • MongoDB example image not working DBZ-9061

  • '||' in ORACLE NVARCHAR data will cause exception DBZ-9132

  • [ORACLE] DDL parsing failed DBZ-9172

  • When using non-recovery snapshot modes, offsets are not reset DBZ-9208

  • Validation for Log Position for SqlServer can fail DBZ-9212

  • Possible regression with throwing DebeziumException rather than warning DBZ-9217

  • Double event publishing via NATS Jetstream sink DBZ-9221

  • Debezium examples github actions fails due to outdated action version DBZ-9222

  • NullPointerException is thrown because DebeziumHeaderProducer is not registered DBZ-9225

  • MongoDB ExtractNewDocumentState SMT crash with nested struct in array in 3.2 DBZ-9231

  • Mongodb incremental snapshot is not honoring additional conditions DBZ-9232

  • WithClause inside an INSERT statement throws DDL parser exception DBZ-9233

  • Oracle snapshot boundary mode does not have a field display name DBZ-9236

  • Request fix for muti-task CREATE TABLE collisions for jdbc postgres target causing task to crash DBZ-9237

  • Oracle split table partition does not support online mode DBZ-9238

  • Exceptionally large mining windows can lead unintended metrics/performance issues DBZ-9241

  • zstd-jni should not be included in connector package DBZ-9273

  • OpenLineage output dataset uses the wrong datatype DBZ-9285

  • Debezium platform verify signal data collection fails DBZ-9290

  • Unchecked exception from OffsetStorageWriter.doFlush() in AsyncEmbeddedEngine leaves semaphore in OffsetStorageWriter unreleased and probably causes engine to fail DBZ-9292

  • Reselect post processor does not work with VariableScaleDecimal primary keys DBZ-9293

  • Duplicate key exception when using postgres connector based on pgoutput plugin DBZ-9305

Other changes

  • Document Debezium operator installation and usage DBZ-8440

  • Create a showcase example for Openlineage DBZ-9058

  • Update the tutorial DBZ-9187

  • Update debezium examples DBZ-9188

  • Document exactly once delivery DBZ-9230

  • Include the raw SinkRecord in the logged output of a JDBC sink record DBZ-9239

  • Switch to smallrye jandex maven plugin DBZ-9246

  • Document JMX setup for Debezium Server DBZ-9282

  • Remove hard line breaks from MariaDB and MySQL properties lists DBZ-9286

  • Support configuring Mockito java agent in java 21+ DBZ-9296

  • Log all rows from LogMiner session logs during LogMiner failures DBZ-9322

×