MongoDB 连接器先前在特定场景下明确偏好使用 secondary。这种明确的用法给希望连接到 primary 节点的用户带来了问题。由于最近的更改（DBZ-6521），情况已不再如此，而是使用连接字符串设置。

得益于（DBZ-6617）的更改，Vitess 连接器的更改事件结构已进行了微调。更改事件的 source 信息块现在包含一个新字段，用于标识事件的源分片。

用户经常表达需要出于各种原因操作连接器偏移量的需求。对于那些不熟悉 Kafka 命令行工具或 Java（如果您使用 Debezium Server）的用户来说，这通常非常困难。得益于 Nathan Smit 的贡献（DBZ-6338），您现在可以从命令行或基于 Web 的界面使用编辑器来操作偏移量。

前往我们的 示例仓库，并按照 README.md 说明开始。

一些 Debezium 连接器先前使用了一个连接器属性 errors.max.retries。此属性控制 Debezium 连接器故障异常被显式包装在 RetriableException 中的次数，但连接器将原始异常抛出给运行时。虽然这听起来类似于 Kafka Connect 的 errors.retry.timeout，但这有效地为用户提供了一种跨多个 Debezium 运行时（包括 Kafka Connect、Debezium Server 和 Debezium Embedded）处理重试的通用方法。

在此版本中，DBZ-6573 统一了此行为，使其可用于所有连接器。

Debezium 的新通知子系统提供了一种简单的方式，可以将第三方工具和应用程序与 Debezium 集成，以深入了解正在进行的变更数据捕获过程，超越传统的 JMX 方法。在 2.4 版本中，通知子系统现在包括了通知初始快照状态的能力（DBZ-6416）。

初始快照通知以 aggregatetType 为 Initial Snapshot 发出，并包含一个 type 字段，该字段显示快照的当前状态。可能的值包括：STARTED、ABORTED、PAUSED、RESUMED、IN_PROGRESS、TABLE_SCAN_COMPLETED 和 COMPLETED。

得益于 Harvey Yue 的贡献（DBZ-6472），MySQL 连接器将在快照阶段使用并行化来生成模式事件。这应该会提高捕获数据库中许多表模式的整体性能。我们计划研究如何将此扩展到其他关系型连接器。

MongoDB 连接器继续看到大量活跃开发。此版本为 MongoDB 引入了几个新功能，包括：

随着我们继续对 MongoDB 连接器进行进一步改进，如果您还有不尽如人意之处或需要增强功能以简化其使用，请告诉我们。

Debezium 2.4 支持几种新的 Oracle 数据类型，包括 XML_TYPE 和 RAW（DBZ-3605）。支持 XML 需要两个新的 Oracle 依赖项：xdb 和 xmlparserv2。这些依赖项不可重新分发，因此默认情况下不包含在连接器插件存档中，这一点与连接器的驱动程序类似。您必须像依赖驱动程序一样，直接从 Maven Central 或 Oracle 获取它们。

此外，XML 的工作方式类似于 CLOB 和 BLOB 数据类型；因此，必须将连接器配置为 lob.enabled 设置为 true 才能摄取 XML 更改。我们很乐意听取您对此新功能的反馈，因为它被要求了很长时间。

得益于 Nicholas Fwang 的贡献（DBZ-6595），JDBC Sink 连接器现在可以在连接器配置属性 table.name.format 中引用更改事件 source 信息块中的值。如果您想引用此类字段，只需在配置中使用 ${source.<field-name>}，系统就会使用该字段的值。

此外，Roman Kudryashov 还贡献了从更改事件上的头信息解析行主键的功能（DBZ-6602）。要使用此新功能，请将连接器配置属性 primary.key.mode 指定为 record_header。如果头信息值是基本类型，您将需要定义一个 primary.key.fields 配置，就像事件的记录键是基本类型时一样。如果头信息值是 struct 类型，默认情况下将使用结构的所有字段，但指定 primary.key.fields 属性允许您从头信息中选择一部分字段作为键。

在某些条件下，Spanner 连接器在初始化期间可能无法从 START_INITIAL_SYNC 状态前进。在 Nancy Xu 进行调查后，引入了一个新的配置选项来提供可配置的超时。这可以通过在连接器的配置中添加以下内容来完成：

Debezium UI 项目允许您使用基于 Web 的界面将任何 Debezium 连接器轻松部署到 Kafka Connect。此版本通过在主连接器列表视图中包含几个连接器指标（DBZ-5321）来改进了界面。我们很乐意收到您对此更改的反馈，并欢迎您对其他有用的指标提出任何建议。