本文主要介绍 TDMQ Pulsar 版集群版本升级记录，及相关注意事项。
3.0.0
发布日期：2025年10月
更新说明：
更新类型 | 更新点 | 详细描述 |
优化 | 引擎版本升级 | 引擎版本升级社区稳定版，跟随社区修复关键问题，如 Broker 优雅重启、升级 Bookie 版本、延迟消息内存使用优化，计算层缓存策略优化等。 |
新增 | Topic Policies | 全面支持 Topic Policy ，支持更多主题维度的策略，用户可灵活配置。 |
新增 | 监控告警 | 后端新增消费监控指标，提升集群监控能力。 |
优化 | 性能优化 | 延迟消息内存使用优化 计算层缓存策略优化 负载均衡策略和 Bundle 卸载机制的优化 存储层支持 DirectIO，提升存储层读写性能 管控接口性能优化 |
2.9.2 版本
发布日期：2023年1月
全量切换：待定
更新说明：
更新类型 | 更新点 | 详细描述 |
优化 | 引擎版本升级 | 引擎版本升级社区稳定版，跟随社区修复关键问题，如 Broker 优雅重启、升级 Bookie 版本、key_shared 订阅模式优化、 unack map 无法缩容 |
新增 | Topic TTL | 引入 Topic Policy ，支持更细粒度的消息 TTL，用户可灵活配置。该功能产品化中。 |
新增 | 消费监控告警 | 后端新增消费监控指标，提升集群监控能力 |
优化 | 性能优化 | 优化 key_shared 订阅模式下的顺序性保证 提升大规模消息堆积下服务端处理性能 提升可用区容灾恢复速度 优化缓存策略，提升消费性能 |
2.7.2 版本
发布日期：2021年5月17日
全量切换：2021年6月
更新说明：
更新类型 | 更新点 | 详细描述 | 相关文档 |
优化 | 统一域名接入 | 每个集群的每种网络环境自动生成唯一的域名作为接入地址，用户无需手动创建和管理接入点。 去除 SDK 中对声明 listenerName 的依赖，从而更好地兼容社区中未适配 Pulsar Multiple advertised listeners 特性的 TCP Client（包括 C++、Python、Node.js）。 | |
新增 | 支持公网接入 | 支持公网访问，允许用户本地或者自建 IDC 的 TCP Client 和腾讯云上的 TDMQ Pulsar 版集群建立连接。 | |
优化 | 重试和死信 Topic 命名规则更新 | 更新重试和死信 Topic 命名规则，保持和 Pulsar 社区一致的样式，更好兼容开源 SDK（原腾讯云版 SDK 将不再适用新的命名规则）。 | |
优化 | 性能优化 | 2.7.1集群在部署上做了系统内核级别的配置优化，相比2.6.x系列的集群峰值生产消费性能提升20%左右，并可根据实际使用情况无感知扩容。 | - |
2.6.1 版本
发布日期：2020年10月12日
全量切换：2020年10月
更新说明：
更新类型 | 更新点 | 详细描述 | 相关文档 |
优化 | 稳定性提升 | 针对内测发现的问题进行集中修复，大幅度提升集群稳定性。 | - |
优化 | zk 冷热隔离 | 内核 pulsar 的 zookeeper 组件采取了冷热数据隔离部署的架构，元数据等数据和集群 broker 配置等数据分开两套 zk 部署，有利于提升集群稳定性。 | - |
新增 | 支持创建虚拟集群 | 支持用户在控制台创建虚拟集群，做一定的资源隔离。 | - |
版本升级说明：
注意
为提升稳定性，存量2.6版本集群可能会由后台升级为2.7集群，我们会在确保兼容性的情况下完成，升级到新版集群后仍保留原有的网络接入方式（即进入集群后配置接入点），但同时无法提供公网和 VPC 域名，如需使用域名接入，请按下方自主切换新版本集群方式操作。
所有新创建的集群会自动使用当前地域最新版本的集群。
如需自主切换到新版本集群，可以按照以下步骤执行：
1.1 新建一个集群（新建的集群均为最新版本），并创建一份完全一致的元数据（命名空间、角色权限、Topic 和订阅）。
1.2 将客户端代码中，原来的生产消费接入点更新为新集群的接入地址。
1.3 将客户端代码中的鉴权信息（Token），更新为新集群的 Token。
1.4 先切换生产客户端（重新构建部署生产端应用到线上）。
1.5 等待原先集群的堆积消息消费完毕后，切换消费客户端（重新构建部署消费端应用到线上）。
