1. 发布
  2. 3.3
  3. Debezium 3.3 发行说明

Debezium 3.3 发行说明

Debezium 发行的所有重要更改都记录在此文件中。发行编号遵循 语义化版本控制。

Release 3.3.1.Final (2025年10月15日)

查看 完整问题列表。

Kafka 兼容性

此版本是基于 Kafka Connect 4.1.0 构建的，并已在 Kafka Broker 版本 4.1.0 上进行了测试。有关与其他 Kafka Broker 版本兼容性的信息，请参阅 Kafka 文档。

升级

在升级任何连接器之前，请务必检查自您使用的版本以来所做的向后不兼容的更改。

当您决定将其中一个连接器从任何早期版本升级到 3.3.1.Final 时，请首先查看您正在使用的版本的迁移说明。正常停止正在运行的连接器，删除旧的插件文件，安装 3.3.1.Final 插件文件，并使用相同的配置重新启动连接器。重新启动后，3.3.1.Final 连接器将继续从先前连接器中断处开始。正如您所料，之前由旧连接器写入 Kafka 的所有更改事件都不会被修改。

如果您使用我们的容器镜像，请不要忘记从 Quay.io 中拉取最新镜像。

重大更改

此发行版中没有重大更改。

新功能

此发行版中没有新功能。

修复

  • MySQL 示例容器镜像配置不正确 DBZ-9485

  • 仅当提供了 dump 文件夹但该文件夹不存在时才记录错误 DBZ-9519

  • 启用 LOB 后，在提交分派期间会错误地跳过事件 DBZ-9521

  • 在正常关机期间，OpenLineage 缺少 Complete 事件 DBZ-9524

  • SchemaUtil 创建了无效的 JSON DBZ-9540

其他更改

  • 文档：记录 `NumberOfErroneousEvents` 指标 DBZ-9510

Release 3.3.0.Final (2025年10月1日)

查看 完整问题列表。

Kafka 兼容性

此版本是基于 Kafka Connect 4.1.0 构建的，并已在 Kafka Broker 版本 4.1.0 上进行了测试。有关与其他 Kafka Broker 版本兼容性的信息，请参阅 Kafka 文档。

升级

在升级任何连接器之前，请务必检查自您使用的版本以来所做的向后不兼容的更改。

当您决定将其中一个连接器从任何早期版本升级到 3.3.0.Final 时，请首先查看您正在使用的版本的迁移说明。正常停止正在运行的连接器，删除旧的插件文件，安装 3.3.0.Final 插件文件，并使用相同的配置重新启动连接器。重新启动后，3.3.0.Final 连接器将继续从先前连接器中断处开始。正如您所料，之前由旧连接器写入 Kafka 的所有更改事件都不会被修改。

如果您使用我们的容器镜像，请不要忘记从 Quay.io 中拉取最新镜像。

重大更改

此发行版中没有重大更改。

新功能

  • 为 Debezium sink 添加 OpenLineage 支持 DBZ-9469

  • Debezium Server NATS JetStream Sink：添加异步消息发布 DBZ-9474

  • 将 commit_scn 添加到 Oracle XStream 事件 DBZ-9497

  • Postgres 连接器修复了 LSN flush 操作中过多的线程创建。 DBZ-9501

修复

  • XStream 在处理低水位标记无效时可能会失败 DBZ-8923

  • 如果 additional-conditions 不正确，则临时阻塞快照可能会导致流永远暂停 DBZ-9494

  • 快照时，当表没有列时，会得到“table is null” DBZ-9500

  • 删除主键不会更改 Oracle 关系元数据 DBZ-9505

其他更改

  • 实现用于管理连接的用户界面 DBZ-9314

  • 在测试套件中强制指定 jackson 版本 DBZ-9495

  • 如果 SPI 接口未正确注册，则 Debezium 构建将失败 DBZ-9503

  • 修复 quarkus postgres 扩展中的 integration-tests 模块名称 DBZ-9514

Release 3.3.0.CR1 (2025年9月24日)

查看 完整问题列表。

Kafka 兼容性

此版本是基于 Kafka Connect 4.1.0 构建的，并已在 Kafka Broker 版本 4.1.0 上进行了测试。有关与其他 Kafka Broker 版本兼容性的信息，请参阅 Kafka 文档。

升级

在升级任何连接器之前，请务必检查自您使用的版本以来所做的向后不兼容的更改。

当您决定将其中一个连接器从任何早期版本升级到 3.3.0.CR1 时，请首先查看您正在使用的版本的迁移说明。正常停止正在运行的连接器，删除旧的插件文件，安装 3.3.0.CR1 插件文件，并使用相同的配置重新启动连接器。重新启动后，3.3.0.CR1 连接器将继续从先前连接器中断处开始。正如您所料，之前由旧连接器写入 Kafka 的所有更改事件都不会被修改。

如果您使用我们的容器镜像，请不要忘记从 Quay.io 中拉取最新镜像。

重大更改

Db2 连接器中的初始偏移量位置验证有时可能产生假阴性。该验证已被禁用，并且作为副产品，移除了对 `when_needed` 快照模式的支持。这只是一个临时限制，并且计划很快提供完整的支持（DBZ-9470）。

Hibernate 7.1 更改了某些数据类型的默认映射，例如时间戳和时间，提供了九位精度而不是六位。这意味着升级后 schema 映射可能会发生变化（DBZ-9481）。

新功能

  • 使 JDBC sink 连接器中的数据库异常可重试 DBZ-7772

  • 添加通过优先级支持多个 Oracle Log Miner 目标 DBZ-9041

  • 升级到 Kafka 4.1.0 DBZ-9460

修复

  • 在关闭时丢弃进程内批处理事务 DBZ-8060

  • 跨两个查询提取的事务可能随机导致不支持的操作 DBZ-8747

  • 非标准数字格式导致 NumberFormatException DBZ-9181

  • Oracle 连接器重新选择异常处理（ORA-01555 + ORA-22924）DBZ-9446

  • 对于只读使用情况，不应使用 DBMS_LOGMNR.DICT_FROM_ONLINE_CATALOG DBZ-9452

  • Debezium Server 因 CNFE 失败 DBZ-9468

  • 在重新创建快照可调用表的列表时发生 OutOfMemory 异常 DBZ-9472

  • Debezium Server 对 SqlServer 源报告“AttributeNotFoundException QueueTotalCapacity”DBZ-9477

  • 当列名包含反引号时，出现“未知列在 'field list' 中”DBZ-9479

  • MySQL 事件获取头信息时抛出 NullPointerException DBZ-9483

其他更改

  • 为 WalPositionLocator 添加单元测试 DBZ-5978

  • 添加 REST API 以检索表列表 DBZ-9317

  • 源和目标实体必须链接到连接实体 DBZ-9333

  • 实现 Kafka 连接验证器 DBZ-9334

  • 取消固定 netty 镜像 DBZ-9390

  • 更新 JDBC Sink 连接器文档，以标识 Debezium 不支持的数据类型 DBZ-9403

  • 公开用于获取连接的 JSON schema 的端点 DBZ-9420

  • 向 Debezium Platform 添加缺失的目标 DBZ-9442

  • 改进 Debezium Platform 的 Maven 编译器配置 DBZ-9453

  • DockerRhel 执行的无 ZooKeeper Kafka DBZ-9462

  • 在 Quarkus 中发布 Postgres 扩展 DBZ-9478

  • 将 Mockito 更新到 5.19.0 DBZ-9480

  • 更新到 AssertJ 3.27.5 DBZ-9482

  • 在 ServiceLoader manifest 中声明 source/transforms，以便与新的插件发现模式兼容 DBZ-9493

Release 3.3.0.Beta1 (2025年9月5日)

查看 完整问题列表。

Kafka 兼容性

此版本是基于 Kafka Connect 4.0.0 构建的，并已在 Kafka Broker 版本 4.0.0 上进行了测试。有关与其他 Kafka Broker 版本兼容性的信息，请参阅 Kafka 文档。

升级

在升级任何连接器之前，请务必检查自您使用的版本以来所做的向后不兼容的更改。

当您决定将其中一个连接器从任何早期版本升级到 3.3.0.Beta1 时，请首先查看您正在使用的版本的迁移说明。正常停止正在运行的连接器，删除旧的插件文件，安装 3.3.0.Beta1 插件文件，并使用相同的配置重新启动连接器。重新启动后，3.3.0.Beta1 连接器将继续从先前连接器中断处开始。正如您所料，之前由旧连接器写入 Kafka 的所有更改事件都不会被修改。

如果您使用我们的容器镜像，请不要忘记从 Quay.io 中拉取最新镜像。

重大更改

Cassandra JMX 指标命名不遵循其他连接器使用的模式。这已得到更改，它使用与其它连接器相同的 streaming/snapshot 命名空间（DBZ-9281）。

Debezium Engine 未设置线程上下文类加载器，这可能会使与 SpringBoot 等项目的集成复杂化。现在已设置线程上下文类加载器，并且 Debezium Engine 使用提供的类加载器来加载其他类，而不仅仅是连接器的类（DBZ-9375）。

新功能

  • 在更新依赖资源时，告知用户任何对现有管道的潜在影响 DBZ-9104

  • 为 MongoEventRouter 添加对 tracing.* 配置选项的支持 DBZ-9328

  • 将外部连接器迁移到 ScheduledHeartbeat DBZ-9377

  • 在不需要时阻止对过滤后的发布的 ALTER PUBLICATION 查询 DBZ-9395

  • Oracle LastBatchProcessingThroughput 应使用 JdbcRows 而不是 CountedChanges DBZ-9399

修复

  • Debezium 未从连接错误中恢复 DBZ-7872

  • JdbcSchemaHistory 在恢复记录时未能处理数据分片 DBZ-8979

  • Quarkus-Debezium-Extension 与 Hibernate ORM 7 不兼容 DBZ-9193

  • 临时阻塞快照失败后，连接器重启时会发生数据丢失 DBZ-9337

  • Oracle 连接器不支持大型 CLOB 和 BLOB 值 DBZ-9392

  • Oracle DDL 解析器异常 - DROP MATERIALIZED DBZ-9397

  • Debezium Platform OpenAPI spec 缺少返回的 schema DBZ-9405

  • Oracle 连接器不解析语法：DDL 中的 PARALLEL DBZ-9406

  • 增加允许的最大 JSON 字符串长度 DBZ-9407

  • task.management.timeout.ms 的错误默认值 DBZ-9408

  • LCR 刷新可能导致低水位线失效 DBZ-9413

  • 当偏移量位置不再有效时，Oracle 连接器将因模糊错误而失败 DBZ-9416

  • 增量快照期间上下文头被添加两次 DBZ-9422

  • Operator CI 在 main 分支上因尝试 checkout core repo 而失败 DBZ-9429

其他更改

  • 停止构建 zookeeper 镜像 DBZ-9189

  • Debezium Engine Quarkus 扩展：创建文档部分 DBZ-9294

  • Debezium Engine Quarkus 扩展：在示例存储库中添加快速入门 DBZ-9301

  • Debezium Engine Quarkus 扩展：博客文章 DBZ-9311

  • 添加 REST API 来验证连接 DBZ-9315

  • MariaDB 连接器文档应清楚说明不支持压缩日志 DBZ-9367

  • EmbeddedEngineTest#shouldHandleNoDefaultOffsetFlushInterval 随机失败 DBZ-9398

  • 提高阻塞快照测试的弹性 DBZ-9410

  • Infinispan Protostream 与 Java 编译器 > 22 的兼容性 DBZ-9417

Release 3.3.0.Alpha2 (2025年8月26日)

查看 完整问题列表。

Kafka 兼容性

此版本是基于 Kafka Connect 4.0.0 构建的，并已在 Kafka Broker 版本 4.0.0 上进行了测试。有关与其他 Kafka Broker 版本兼容性的信息，请参阅 Kafka 文档。

升级

在升级任何连接器之前，请务必检查自您使用的版本以来所做的向后不兼容的更改。

当您决定将其中一个连接器从任何早期版本升级到 3.3.0.Alpha2 时，请首先查看您正在使用的版本的迁移说明。正常停止正在运行的连接器，删除旧的插件文件，安装 3.3.0.Alpha2 插件文件，并使用相同的配置重新启动连接器。重新启动后，3.3.0.Alpha2 连接器将继续从先前连接器中断处开始。正如您所料，之前由旧连接器写入 Kafka 的所有更改事件都不会被修改。

如果您使用我们的容器镜像，请不要忘记从 Quay.io 中拉取最新镜像。

重大更改

此发行版中没有重大更改。

新功能

  • 为 Postgres Sink 连接器支持 TSVECTOR 数据类型 DBZ-8471

  • 改进 Debezium Platform 后端的错误管理和消息 DBZ-8836

  • 添加 UI 支持精细化日志记录配置 DBZ-8890

  • 更新教程以使用 KRaft 模式 DBZ-9184

  • 添加对 MongoDB Source Connector 的支持，以便从指定点开始 CDC DBZ-9240

  • 为 ALTER/CREATE Publication 语句引入超时 DBZ-9310

  • 允许重做线程刷新 SCN 调整可配置 DBZ-9344

  • 提高验证提供的 is_toast 列值的性能 DBZ-9345

  • SQL Server 在追赶时会发出心跳 DBZ-9364

  • 为源和目标添加详细信息页面 DBZ-9373

修复

  • 增量快照偏移量在任务重启时无法加载 DBZ-9209

  • 在父 pom 中将 kafka.version 更新到 4.0.0 DBZ-9300

  • Debezium Server Azure Event Hubs sink 重复所有之前的事件 DBZ-9304

  • 归档日志仅模式在没有更多可用数据时不会暂停挖掘 DBZ-9306

  • EventDispatcherTest 中的 Mockit 错误 DBZ-9332

  • 使用多个任务时，事件可能会被错误地处理多次 DBZ-9338

  • Debezium 持续执行 heartbeat.action.query，而不是遵循 heartbeat.interval.ms DBZ-9340

  • OCP 测试启动失败 DBZ-9342

  • 获取事务事件计数可能导致 NullPointerException DBZ-9349

  • 确保 dbz 服务器启动时 JAVA_OPTS 环境变量正确 DBZ-9352

  • 当字段的 schema 类型为 BYTES 时，ReselectColumnsPostProcessor 出现问题 DBZ-9356

  • MariaDB 无法解析使用 RENAME COLUMN IF EXISTS 语法的 ALTER TABLE DBZ-9358

  • 当表结构更改并抛出 ORA-01466 时，Oracle 无法重新选择列 DBZ-9359

  • 在创建操作中，单引号被双引号括起来 DBZ-9366

  • 使用归档日志仅模式时，挖掘上限计算错误 DBZ-9370

  • 由于 record.key 序列化错误，Kafka 生产者异常未正确记录 DBZ-9378

其他更改

  • 在下游构建中包含 XStream 类 DBZ-8828

  • 删除 UI 中显示的任何无效占位符值 DBZ-9106

  • 在 Db2 连接器文档中明确 IBM DB2 IIDR 许可要求 DBZ-9121

  • 记录创建 Oracle LogMiner 用户更严格的配置 DBZ-9129

  • 创建连接的 REST 资源 DBZ-9313

  • 改进检查提交消息的 Github Action DBZ-9327

  • 将 assertj 更新到 3.27.4 DBZ-9343

  • 添加、移除或转换开发预览和技术预览说明 DBZ-9347

  • 为 LogMiner 的非缓冲模式创建文档 DBZ-9351

Release 3.3.0.Alpha1 (2025年8月5日)

查看 完整问题列表。

Kafka 兼容性

此版本是基于 Kafka Connect 4.0.0 构建的，并已在 Kafka Broker 版本 4.0.0 上进行了测试。有关与其他 Kafka Broker 版本兼容性的信息，请参阅 Kafka 文档。

升级

在升级任何连接器之前，请务必检查自您使用的版本以来所做的向后不兼容的更改。

当您决定将其中一个连接器从任何早期版本升级到 3.3.0.Alpha1 时，请首先查看您正在使用的版本的迁移说明。正常停止正在运行的连接器，删除旧的插件文件，安装 3.3.0.Alpha1 插件文件，并使用相同的配置重新启动连接器。重新启动后，3.3.0.Alpha1 连接器将继续从先前连接器中断处开始。正如您所料，之前由旧连接器写入 Kafka 的所有更改事件都不会被修改。

如果您使用我们的容器镜像，请不要忘记从 Quay.io 中拉取最新镜像。

重大更改

已移除已弃用的快照模式名称。连接器配置必须使用新名称（DBZ-8171）。

新功能

  • 在 Oracle 只读副本中执行 Debezium DBZ-8319

  • 为 postgres 源连接器支持 TSVECTOR 数据类型 DBZ-8470

  • 支持 MariaDB 11.7+ vector 数据类型 DBZ-8582

  • 精细化日志记录配置 DBZ-8638

  • 在挖掘会话期间，将 ORA-00310 重做日志视为不一致 DBZ-8870

  • 智能编辑器：添加能力，直接使用 debezium 服务器配置创建完整的管道 DBZ-8873

  • 智能编辑器：提供格式之间自动转换的支持 DBZ-8888

  • 为缓存事件添加 JMX 指标/统计信息 DBZ-8991

  • 引入一种方法来使用 decimal.handling.mode 恢复旧的数字行为 DBZ-9166

  • 移除配置中的心跳创建，改用 HeartbeatFactory DBZ-9176

  • 简化 debezium-connector-vitess 集成测试的 dockerfile DBZ-9216

  • 将 Outbox Extension 更新到 Quarkus 3.23.4 & 调整到 Hibernate 7.x DBZ-9219

  • 在网站上为图片添加 Lightbox DBZ-9227

  • Azure Event Hub sink - 内置支持哈希分区键 DBZ-9245

  • 在 Debezium-connector-postgres 中，当缺失心跳表时抛出异常 DBZ-9247

  • 添加配置以禁用与 OpenLineage 一起添加的 Context 标头 DBZ-9248

  • 添加指定是否为 LogMiner 使用基于 CTE 的查询的能力 DBZ-9272

  • 允许 Oracle 心跳操作查询错误处理程序对 ORA-02396 保持弹性 DBZ-9280

  • 将 Informix JDBC 驱动程序更新到 4.50.12 DBZ-9288

  • 发布 CockroachDB 连接器 DBZ-9289

  • Chart 版本控制必须符合 SemVer DBZ-8913

  • 为镜像添加符合 SemVer 的附加标签 DBZ-8914

  • Debezium Engine Quarkus 扩展：支持心跳事件监听器 DBZ-8960

  • Debezium Engine Quarkus 扩展：自定义反序列化器 DBZ-8962

  • Debezium Engine Quarkus 扩展：引入 PostProcessor 处理程序 DBZ-8965

  • Debezium Engine Quarkus 扩展：添加对自定义转换器的支持 DBZ-8966

  • 为主要 Debezium 连接器添加 EOS 支持 DBZ-9177

  • 避免在历史主题中存储不相关的 DDL 语句 DBZ-9186

修复

  • 用户选择在管道设计器中未持久化 DBZ-8761

  • MongoDB 示例镜像不工作 DBZ-9061

  • ORACLE NVARCHAR 数据中的 '||' 会导致异常 DBZ-9132

  • [ORACLE] DDL 解析失败 DBZ-9172

  • 在使用非恢复快照模式时，偏移量未重置 DBZ-9208

  • SqlServer 的日志位置验证可能会失败 DBZ-9212

  • 可能出现回归，抛出 DebeziumException 而非警告 DBZ-9217

  • 通过 NATS Jetstream sink 双重发布事件 DBZ-9221

  • Debezium 示例 github actions 因过时的 action 版本而失败 DBZ-9222

  • 由于 DebeziumHeaderProducer 未注册，抛出 NullPointerException DBZ-9225

  • MongoDB ExtractNewDocumentState SMT 在 3.2 版本中崩溃，出现数组中的嵌套结构 DBZ-9231

  • Mongodb 增量快照未遵守附加条件 DBZ-9232

  • INSERT 语句中的 WithClause 抛出 DDL 解析器异常 DBZ-9233

  • Oracle 快照边界模式没有字段显示名称 DBZ-9236

  • 请求修复 jdbc postgres 目标的多任务 CREATE TABLE 冲突，导致任务崩溃 DBZ-9237

  • Oracle 分区表拆分不支持在线模式 DBZ-9238

  • 异常大的挖掘窗口可能导致意外的指标/性能问题 DBZ-9241

  • zstd-jni 不应包含在连接器包中 DBZ-9273

  • OpenLineage 输出数据集使用错误的数据类型 DBZ-9285

  • Debezium platform 验证信号数据收集失败 DBZ-9290

  • AsyncEmbeddedEngine 中的 OffsetStorageWriter.doFlush() 抛出未检查的异常，导致 OffsetStorageWriter 中的信号量未释放，可能导致引擎失败 DBZ-9292

  • Reselect 后处理器无法处理 VariableScaleDecimal 主键 DBZ-9293

  • 使用基于 pgoutput 插件的 postgres 连接器时出现重复键异常 DBZ-9305

其他更改

  • 记录 Debezium operator 的安装和使用 DBZ-8440

  • 为 Openlineage 创建一个示例展示 DBZ-9058

  • 更新教程 DBZ-9187

  • 更新 debezium 示例 DBZ-9188

  • 记录精确一次传递 DBZ-9230

  • 在 JDBC sink 记录的日志输出中包含原始 SinkRecord DBZ-9239

  • 切换到 smallrye jandex maven 插件 DBZ-9246

  • 记录 Debezium Server 的 JMX 设置 DBZ-9282

  • 移除 MariaDB 和 MySQL 属性列表中的硬换行符 DBZ-9286

  • 支持在 java 21+ 中配置 Mockito java agent DBZ-9296

  • 在 LogMiner 失败期间记录 LogMiner 会话日志中的所有行 DBZ-9322

版权所有 © Debezium 及其作者。保留所有权利。有关我们的商标详情，请访问我们的 商标政策 和 商标列表。第三方商标属于其各自所有者，在此提及并不表示任何认可或关联。
×