|
| 1 | +--- |
| 2 | +layout: release-notes |
| 3 | +title: Release Notes for Debezium 3.3 |
| 4 | +debezium-version: "3.3" |
| 5 | +--- |
| 6 | +:toc: |
| 7 | +:toc-placement: macro |
| 8 | +:toclevels: 1 |
| 9 | +:sectanchors: |
| 10 | +:linkattrs: |
| 11 | +:icons: font |
| 12 | + |
| 13 | +All notable changes for Debezium releases are documented in this file. |
| 14 | +Release numbers follow http://semver.org[Semantic Versioning]. |
| 15 | + |
| 16 | +toc::[] |
| 17 | + |
| 18 | +[[release-3.3.0-alpha1]] |
| 19 | +== *Release 3.3.0.Alpha1* _(August 5th 2025)_ |
| 20 | + |
| 21 | +See the https://issues.redhat.com/secure/ReleaseNote.jspa?projectId=12317320&version=12464154[complete list of issues]. |
| 22 | + |
| 23 | +=== Kafka compatibility |
| 24 | + |
| 25 | +This release has been built against Kafka Connect 4.0.0 and has been tested with version 4.0.0 of the Kafka brokers. |
| 26 | +See the https://kafka.apache.org/documentation/#upgrade[Kafka documentation] for compatibility with other versions of Kafka brokers. |
| 27 | + |
| 28 | + |
| 29 | +=== Upgrading |
| 30 | + |
| 31 | +Before upgrading any connector, be sure to check the backward-incompatible changes that have been made since the release you were using. |
| 32 | + |
| 33 | +When you decide to upgrade one of these connectors to 3.3.0.Alpha1 from any earlier versions, |
| 34 | +first check the migration notes for the version you're using. |
| 35 | +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. |
| 36 | +Upon restart, the 3.3.0.Alpha1 connectors will continue where the previous connector left off. |
| 37 | +As one might expect, all change events previously written to Kafka by the old connector will not be modified. |
| 38 | + |
| 39 | +If you are using our container images, then please do not forget to pull them fresh from https://quay.io/organization/debezium[Quay.io]. |
| 40 | + |
| 41 | + |
| 42 | +=== Breaking changes |
| 43 | + |
| 44 | +Deprecated names of snapshot modes were removed. Connector configuration must use new names (https://issues.redhat.com/browse/DBZ-8171[DBZ-8171]). |
| 45 | + |
| 46 | + |
| 47 | + |
| 48 | +=== New features |
| 49 | + |
| 50 | +* Execute Debezium in oracle readonly replica https://issues.redhat.com/browse/DBZ-8319[DBZ-8319] |
| 51 | +* Support for TSVECTOR data types for postgres source connector https://issues.redhat.com/browse/DBZ-8470[DBZ-8470] |
| 52 | +* Support MariaDB 11.7+ vector data type https://issues.redhat.com/browse/DBZ-8582[DBZ-8582] |
| 53 | +* Fine-grained logging configuration https://issues.redhat.com/browse/DBZ-8638[DBZ-8638] |
| 54 | +* During a mining session treat ORA-00310 redo logs being inconsistent https://issues.redhat.com/browse/DBZ-8870[DBZ-8870] |
| 55 | +* Smart editor: Add the ability to create a complete pipeline directly using the debezium server configuration https://issues.redhat.com/browse/DBZ-8873[DBZ-8873] |
| 56 | +* Smart editor: Provide support for an auto conversion between formats https://issues.redhat.com/browse/DBZ-8888[DBZ-8888] |
| 57 | +* Add JMX metrics/statistics for cached events https://issues.redhat.com/browse/DBZ-8991[DBZ-8991] |
| 58 | +* Introduce a way to restore the legacy numeric behavior with decimal.handling.mode https://issues.redhat.com/browse/DBZ-9166[DBZ-9166] |
| 59 | +* Remove heartbeat creation from configuration in favor of HeartbeatFactory https://issues.redhat.com/browse/DBZ-9176[DBZ-9176] |
| 60 | +* Simplify dockerfile for debezium-connector-vitess itests https://issues.redhat.com/browse/DBZ-9216[DBZ-9216] |
| 61 | +* Update Outbox Extension to Quarkus 3.23.4 & Align to Hibernate 7.x https://issues.redhat.com/browse/DBZ-9219[DBZ-9219] |
| 62 | +* Add Lightbox on website for images https://issues.redhat.com/browse/DBZ-9227[DBZ-9227] |
| 63 | +* Azure Event Hub sink - built-in support for hashing partition keys https://issues.redhat.com/browse/DBZ-9245[DBZ-9245] |
| 64 | +* Throw an exception on missing heartbeat table on Debezium-connector-postgres https://issues.redhat.com/browse/DBZ-9247[DBZ-9247] |
| 65 | +* Add configuration to disable Context headers added with OpenLineage https://issues.redhat.com/browse/DBZ-9248[DBZ-9248] |
| 66 | +* Add ability to specify whether to use a CTE-based query for LogMiner https://issues.redhat.com/browse/DBZ-9272[DBZ-9272] |
| 67 | +* Allow Oracle heartbeat action query error handler to be resilient to ORA-02396 https://issues.redhat.com/browse/DBZ-9280[DBZ-9280] |
| 68 | +* Uppdate Informix JDBC Driver to 4.50.12 https://issues.redhat.com/browse/DBZ-9288[DBZ-9288] |
| 69 | +* Release CockroachDB connector https://issues.redhat.com/browse/DBZ-9289[DBZ-9289] |
| 70 | +* Chart versioning must be SemVer compliant https://issues.redhat.com/browse/DBZ-8913[DBZ-8913] |
| 71 | +* Add additional tag to images compliant with SemVer https://issues.redhat.com/browse/DBZ-8914[DBZ-8914] |
| 72 | +* Debezium Engine Quarkus Extension: Support Heartbeat Event Listener https://issues.redhat.com/browse/DBZ-8960[DBZ-8960] |
| 73 | +* Debezium Engine Quarkus Extension: custom deserializer https://issues.redhat.com/browse/DBZ-8962[DBZ-8962] |
| 74 | +* Debezium Engine Quarkus Extension: introduce PostProcessor handler https://issues.redhat.com/browse/DBZ-8965[DBZ-8965] |
| 75 | +* Debezium Engine Quarkus Extension: Add Support to Custom Converter https://issues.redhat.com/browse/DBZ-8966[DBZ-8966] |
| 76 | +* Add EOS support into main Debezium connectors https://issues.redhat.com/browse/DBZ-9177[DBZ-9177] |
| 77 | +* Avoid storing irrelevant DDL statements in history topic https://issues.redhat.com/browse/DBZ-9186[DBZ-9186] |
| 78 | + |
| 79 | + |
| 80 | +=== Fixes |
| 81 | + |
| 82 | +* User selection is not persistence in pipeline designer https://issues.redhat.com/browse/DBZ-8761[DBZ-8761] |
| 83 | +* MongoDB example image not working https://issues.redhat.com/browse/DBZ-9061[DBZ-9061] |
| 84 | +* '||' in ORACLE NVARCHAR data will cause exception https://issues.redhat.com/browse/DBZ-9132[DBZ-9132] |
| 85 | +* [ORACLE] DDL parsing failed https://issues.redhat.com/browse/DBZ-9172[DBZ-9172] |
| 86 | +* When using non-recovery snapshot modes, offsets are not reset https://issues.redhat.com/browse/DBZ-9208[DBZ-9208] |
| 87 | +* Validation for Log Position for SqlServer can fail https://issues.redhat.com/browse/DBZ-9212[DBZ-9212] |
| 88 | +* Possible regression with throwing DebeziumException rather than warning https://issues.redhat.com/browse/DBZ-9217[DBZ-9217] |
| 89 | +* Double event publishing via NATS Jetstream sink https://issues.redhat.com/browse/DBZ-9221[DBZ-9221] |
| 90 | +* Debezium examples github actions fails due to outdated action version https://issues.redhat.com/browse/DBZ-9222[DBZ-9222] |
| 91 | +* NullPointerException is thrown because DebeziumHeaderProducer is not registered https://issues.redhat.com/browse/DBZ-9225[DBZ-9225] |
| 92 | +* MongoDB ExtractNewDocumentState SMT crash with nested struct in array in 3.2 https://issues.redhat.com/browse/DBZ-9231[DBZ-9231] |
| 93 | +* Mongodb incremental snapshot is not honoring additional conditions https://issues.redhat.com/browse/DBZ-9232[DBZ-9232] |
| 94 | +* WithClause inside an INSERT statement throws DDL parser exception https://issues.redhat.com/browse/DBZ-9233[DBZ-9233] |
| 95 | +* Oracle snapshot boundary mode does not have a field display name https://issues.redhat.com/browse/DBZ-9236[DBZ-9236] |
| 96 | +* Request fix for muti-task CREATE TABLE collisions for jdbc postgres target causing task to crash https://issues.redhat.com/browse/DBZ-9237[DBZ-9237] |
| 97 | +* Oracle split table partition does not support online mode https://issues.redhat.com/browse/DBZ-9238[DBZ-9238] |
| 98 | +* Exceptionally large mining windows can lead unintended metrics/performance issues https://issues.redhat.com/browse/DBZ-9241[DBZ-9241] |
| 99 | +* zstd-jni should not be included in connector package https://issues.redhat.com/browse/DBZ-9273[DBZ-9273] |
| 100 | +* OpenLineage output dataset uses the wrong datatype https://issues.redhat.com/browse/DBZ-9285[DBZ-9285] |
| 101 | +* Debezium platform verify signal data collection fails https://issues.redhat.com/browse/DBZ-9290[DBZ-9290] |
| 102 | +* Unchecked exception from OffsetStorageWriter.doFlush() in AsyncEmbeddedEngine leaves semaphore in OffsetStorageWriter unreleased and probably causes engine to fail https://issues.redhat.com/browse/DBZ-9292[DBZ-9292] |
| 103 | +* Reselect post processor does not work with VariableScaleDecimal primary keys https://issues.redhat.com/browse/DBZ-9293[DBZ-9293] |
| 104 | +* Duplicate key exception when using postgres connector based on pgoutput plugin https://issues.redhat.com/browse/DBZ-9305[DBZ-9305] |
| 105 | + |
| 106 | + |
| 107 | +=== Other changes |
| 108 | + |
| 109 | +* Document Debezium operator installation and usage https://issues.redhat.com/browse/DBZ-8440[DBZ-8440] |
| 110 | +* Create a showcase example for Openlineage https://issues.redhat.com/browse/DBZ-9058[DBZ-9058] |
| 111 | +* Update the tutorial https://issues.redhat.com/browse/DBZ-9187[DBZ-9187] |
| 112 | +* Update debezium examples https://issues.redhat.com/browse/DBZ-9188[DBZ-9188] |
| 113 | +* Document exactly once delivery https://issues.redhat.com/browse/DBZ-9230[DBZ-9230] |
| 114 | +* Include the raw SinkRecord in the logged output of a JDBC sink record https://issues.redhat.com/browse/DBZ-9239[DBZ-9239] |
| 115 | +* Switch to smallrye jandex maven plugin https://issues.redhat.com/browse/DBZ-9246[DBZ-9246] |
| 116 | +* Document JMX setup for Debezium Server https://issues.redhat.com/browse/DBZ-9282[DBZ-9282] |
| 117 | +* Remove hard line breaks from MariaDB and MySQL properties lists https://issues.redhat.com/browse/DBZ-9286[DBZ-9286] |
| 118 | +* Support configuring Mockito java agent in java 21+ https://issues.redhat.com/browse/DBZ-9296[DBZ-9296] |
| 119 | +* Log all rows from LogMiner session logs during LogMiner failures https://issues.redhat.com/browse/DBZ-9322[DBZ-9322] |
| 120 | + |
0 commit comments