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.Alpha1 (August 5th 2025)
See the complete list of issues.
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