Release Notes for Debezium 3.1

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

Release 3.1.0.Alpha1 (January 20th 2025)

Kafka compatibility

This release has been built against Kafka Connect 3.9.0 and has been tested with version 3.9.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.1.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.1.0.Alpha1 plugin files, and restart the connector using the same configuration. Upon restart, the 3.1.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

Source info block schema was not versioned in past Debezium versions. This could lead to schema compatibility issue when changed. The schema version is now set to 1 and will be incremented with future changes (DBZ-8499).

Debeizum intoroduce SparseVector datatype for PostgreSQL sparsevec data. This release introduces support for Oracle vector datatypes and SparseVector was renamed so it became cross-connector type (DBZ-8585).

New features

  • Support new non adaptive temporal values DBZ-6387

  • Add MariaDB SSL support DBZ-8482

  • Update the pipeline designer flow UI to remove the multi moving circle to just have one instead. DBZ-8532

  • Sqlserver connector requires unbounded memory to process big transactions DBZ-8557

  • Use enum set strings flag available in Vitess v20 for decoding enums/sets DBZ-8561

  • Pulsar Producer Batcher Builder - Key Based Batching DBZ-8563

  • Prototype support of WASM in Debezium transformation DBZ-8568

  • S3 storage can force path-style addressing DBZ-8569

  • Support MySQL and PostgreSQL vector data types DBZ-8571

Fixes

  • Exception during commit offsets won’t trigger retry logic. DBZ-2386

  • Fix invalid gtid error on startup when ordered tx metadata enabled DBZ-8541

  • Debezium operator generate wrong offset and schema history properties DBZ-8543

  • A recent log switch may be seen as consistent during log gathering DBZ-8546

  • Content-based routing expression variable headers is singular in code DBZ-8550

  • MongoDataConverter does not recognize nested empty array DBZ-8572

  • Fix issues in Transformation UI sections DBZ-8575

  • ORA-65040 occurs on log switches when log.mining.restart.connection is enabled and connection defaults to PDB rather than CDB$ROOT DBZ-8577

Other changes

  • Remove mongo-initiator images DBZ-8487

  • Support storages supported by Debezium operator for pipeline in Debezium platform DBZ-8512

  • Setup minimum CI pipeline for debezium-platform-conductor DBZ-8527

  • Missing quick profile in test containers module DBZ-8545

  • Upgrade MongoDB driver to 5.2 DBZ-8554

  • Move to Quarkus 3.17.7 for the Outbox Extension DBZ-8583

  • Use latest tag instead of nightly for conductor image DBZ-8589