2.4. 将 Debezium 从版本 1.x 升级到 2.3.4
当前版本的 Debezium 包括在从 2.1.4 之前的版本升级时,需要您执行特定步骤的更改。
2.4.1. 将连接器升级到 Debezium 2.3.4 复制链接链接已复制到粘贴板!
复制链接链接已复制到粘贴板!
Debezium 2.3.4 发行版本包括一些与早于 2.x 的 Debezium 版本不兼容的一些更改。因此,在从 Debezium 1.x 版本升级到 2.3.4 时保留数据并确保继续操作,您必须在升级过程中完成一些手动步骤。
一个显著的更改是某些连接器参数的名称已更改。要容纳这些更改,请查看 2023.Q2 发行注记中的 配置属性更新,并记录您的连接器配置中存在的属性。在升级前,编辑每个 Debezium 连接器的配置,以添加任何更改的属性的新名称。在升级前,编辑任何 1.x 连接器实例的配置,以便存在旧属性和新属性名称。升级后,您可以删除旧的配置选项。
前提条件
- Debezium 现在与 Kafka 版本兼容,最多 3.5.0。这是 AMQ Streams 2.5 中的默认 Kafka 版本。
- 需要 Java 11 运行时,必须在升级前使用。AMQ Streams 2.5 支持 Java 11。在开发新应用程序时使用 Java 11。Java 11 允许使用最新的语言更新,如新的 String API 和 predicate 支持的变化,同时受益于 Java 性能改进。AMQ Streams 2.5 不再支持 Java 8。
- 检查当前 更改以及 2023.Q2 发行注记中的与向后兼容性相关的更改。
- 验证您的环境是否符合 Debezium 2.3.4 支持的配置。
流程
- 在 OpenShift 控制台中,查看 Kafka Connector YAML 来识别在 Debezium 2.3.4 中不再有效的连接器配置。详情请参阅 2023.Q2 发行注记。
- 编辑配置,为在第 1 步中识别的属性添加 2.x 等效项,以便存在旧属性和新属性名称。将新属性的值设置为之前为旧属性指定的值。
- 在 OpenShift 控制台中,停止 Kafka Connect 以安全停止连接器。
- 在 OpenShift 控制台中,编辑 Kafka Connect 镜像 YAML 来引用连接器 zip 文件的 Debezium 2.3.4.Final 版本。
- 在 OpenShift 控制台中,编辑 Kafka Connector YAML 以删除不再对连接器有效的配置选项。
- 根据需要调整应用程序的存储依赖项,具体取决于代码中的存储模块实现依赖项。如需更多信息,请参阅 2023.Q2 发行注记中的 Debezium 存储的变化。
- 重启 Kafka Connect 以启动连接器。重启连接器后,它会从升级前停止的时间点继续处理事件。在不修改升级前,更改连接器写入 Kafka 的事件记录。