diff --git a/_data/releases/2.4/2.4.0.Beta2.yml b/_data/releases/2.4/2.4.0.Beta2.yml new file mode 100644 index 00000000000..0303f023d53 --- /dev/null +++ b/_data/releases/2.4/2.4.0.Beta2.yml @@ -0,0 +1,5 @@ +date: 2023-09-13 +version: "2.4.0.Beta2" +stable: false +summary: Experimental streaming from Oracle using OpenLogReplicator; SMT for configurable timezone conversion; Support for MongoDB 7; MongoDB stream can ignore large documents that breaks it +#announcement_url: diff --git a/releases/2.4/release-notes.asciidoc b/releases/2.4/release-notes.asciidoc index b11bf560364..94393cda427 100644 --- a/releases/2.4/release-notes.asciidoc +++ b/releases/2.4/release-notes.asciidoc @@ -15,6 +15,83 @@ Release numbers follow http://semver.org[Semantic Versioning]. toc::[] +[[release-2.4.0-beta2]] +== *Release 2.4.0.Beta2* _(September 13rd 2023)_ + +See the https://issues.redhat.com/secure/ReleaseNote.jspa?projectId=12317320&version=12412109[complete list of issues]. + +=== Kafka compatibility + +This release has been built against Kafka Connect 3.5.1 and has been tested with version 3.5.1 of the Kafka brokers. +See the https://kafka.apache.org/documentation/#upgrade[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 2.4.0.Beta2 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 2.4.0.Beta2 plugin files, and restart the connector using the same configuration. +Upon restart, the 2.4.0.Beta2 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 https://quay.io/organization/debezium[Quay.io]. + + +=== Breaking changes + +Deprecated MongoDB connection connfiguration via `mongodb.hosts` and `mongodb.members.autodiscover` options was removed. +Only configuration via connection string is now supported (https://issues.redhat.com/browse/DBZ-6892[DBZ-6892]). + + +=== New features + +* Ingest changes via OpenLogReplicator https://issues.redhat.com/browse/DBZ-2543[DBZ-2543] +* Only publish deltas instead of full snapshots to reduce size of sync event messages https://issues.redhat.com/browse/DBZ-6458[DBZ-6458] +* SMT for handling timezone conversions https://issues.redhat.com/browse/DBZ-6567[DBZ-6567] +* Support custom authentication on MongoDB connector https://issues.redhat.com/browse/DBZ-6741[DBZ-6741] +* Document `mongodb.authentication.class` https://issues.redhat.com/browse/DBZ-6788[DBZ-6788] +* Support truncating large columns https://issues.redhat.com/browse/DBZ-6844[DBZ-6844] +* Always reset VStream grpc channel when max size is exceeded https://issues.redhat.com/browse/DBZ-6852[DBZ-6852] +* Add an overview page for Connector detail https://issues.redhat.com/browse/DBZ-6856[DBZ-6856] +* Avoid getting NPE when executing the arrived method in ExecuteSnapshot https://issues.redhat.com/browse/DBZ-6865[DBZ-6865] +* Configurable order of user defined and internal aggregation pipeline https://issues.redhat.com/browse/DBZ-6872[DBZ-6872] +* Add support for MongoDB 7 https://issues.redhat.com/browse/DBZ-6882[DBZ-6882] + + +=== Fixes + +* Documentation content section in the debezium.io scroll over to the top header. https://issues.redhat.com/browse/DBZ-5942[DBZ-5942] +* Postgres - Incremental snapshot fails on tables with an enum type in the primary key https://issues.redhat.com/browse/DBZ-6481[DBZ-6481] +* schema.history.internal.store.only.captured.databases.ddl flag not considered while snapshot schema to history topic https://issues.redhat.com/browse/DBZ-6712[DBZ-6712] +* ExtractNewDocumentState for MongoDB ignore previous document state when handling delete event's with REWRITE https://issues.redhat.com/browse/DBZ-6725[DBZ-6725] +* MongoDB New Document State Extraction: original name overriding does not work https://issues.redhat.com/browse/DBZ-6773[DBZ-6773] +* Error with propagation source column name https://issues.redhat.com/browse/DBZ-6831[DBZ-6831] +* Kafka offset store fails with NPE https://issues.redhat.com/browse/DBZ-6853[DBZ-6853] +* JDBC Offset storage - configuration of table name does not work https://issues.redhat.com/browse/DBZ-6855[DBZ-6855] +* JDBC sink insert fails with Oracle target database due to semicolon https://issues.redhat.com/browse/DBZ-6857[DBZ-6857] +* Oracle test shouldContinueToUpdateOffsetsEvenWhenTableIsNotChanged fails with NPE https://issues.redhat.com/browse/DBZ-6860[DBZ-6860] +* Tombstone events causes NPE on JDBC connector https://issues.redhat.com/browse/DBZ-6862[DBZ-6862] +* Debezium-MySQL not filtering AWS RDS internal events https://issues.redhat.com/browse/DBZ-6864[DBZ-6864] +* errors.max.retries = 0 Causes retrievable error to be ignored https://issues.redhat.com/browse/DBZ-6866[DBZ-6866] +* Streaming aggregation pipeline broken for combination of database filter and signal collection https://issues.redhat.com/browse/DBZ-6867[DBZ-6867] +* ChangeStream aggregation pipeline fails on large documents which should be excluded https://issues.redhat.com/browse/DBZ-6871[DBZ-6871] +* Oracle alter table drop constraint fails when cascading index https://issues.redhat.com/browse/DBZ-6876[DBZ-6876] + + +=== Other changes + +* Docs for Timezone SMT https://issues.redhat.com/browse/DBZ-6835[DBZ-6835] +* Write a blog post for custom properties step in DBZ UI https://issues.redhat.com/browse/DBZ-6838[DBZ-6838] +* Improve website/documentation artifact links https://issues.redhat.com/browse/DBZ-6850[DBZ-6850] +* Add possibility to add on-demand adjusted testing farm execution https://issues.redhat.com/browse/DBZ-6854[DBZ-6854] +* Oracle connector test suite logging no longer works https://issues.redhat.com/browse/DBZ-6859[DBZ-6859] +* Increase Oracle log level to DEBUG for several key important log messages https://issues.redhat.com/browse/DBZ-6880[DBZ-6880] +* Document cursor pipeline ordering and oversize document handling mode https://issues.redhat.com/browse/DBZ-6883[DBZ-6883] + + + [[release-2.4.0-beta1]] == *Release 2.4.0.Beta1* _(August 29th 2023)_