tencent cloud

消息队列 RocketMQ 版

动态与公告
新功能发布记录
公告
产品简介
产品概述
什么是消息队列 RocketMQ 版
产品优势
应用场景
产品系列
开源对比
高可用
使用限制
开服地域
基本概念
产品计费
计费概述
价格说明
计费示例
切换集群计费模式(5.x)
续费说明
查看消费明细
退费说明
欠费说明
快速入门
快速入门概述
准备工作
步骤1:创建 RocketMQ 资源
步骤2:使用 SDK 收发消息(推荐)
步骤2:运行 RocketMQ 客户端(可选)
步骤3:查询消息
步骤4:销毁资源
用户指南
使用流程指引
配置账号权限
新建集群
命名空间管理
配置 Topic
配置 Group
连接集群
管理消息
管理集群
查看监控和配置告警
跨集群复制消息
实践教程
RocketMQ 常见概念命名规范
RocketMQ 客户端实践
RocketMQ 性能压测和容量评估
使用社区版 HTTP SDK 接入
客户端风险说明和更新指南
关于 RocketMQ 4.x 集群角色(Role)相关云 API 迁移指引
迁移指南
有感迁移
无感迁移
开发指南
消息类型
消息过滤
消息重试
POP 消费模式(5.x)
集群消费与广播消费
订阅关系一致性
限流
API 参考(5.x)
History
API Category
Making API Requests
Topic APIs
Consumer Group APIs
Message APIs
Role Authentication APIs
Hitless Migration APIs
Cloud Migration APIs
Cluster APIs
Data Types
Error Codes
API 参考(4.x)
SDK 参考
SDK 概述
5.x SDK
4.x SDK
安全与合规
权限管理
云 API 审计
删除保护
常见问题
4.x 实例常见问题
服务协议
服务等级协议
联系我们

主题间消息复制

PDF
聚焦模式
字号
最后更新时间: 2026-01-23 16:50:33

操作场景

TDMQ RocketMQ 支持客户在两个集群之间同步消息:同个地域或不同地域间;4.x 集群之间,5.x 集群之间,4.x 到 5.x 集群的复制(反向同步,即消息从5.x集群复制到4.x集群暂不支持),您可以按照 Topic 维度,把集群 A 的某个 Topic 的消息复制到集群 B 的某个 Topic。在进行某个 Topic 的消息复制时,RocketMQ 支持按照特定的条件进行过滤(例如 Tag 或者 SQL 表达式),支持复制任务的任意启停,并且支持通过监控查看复制任务的进度和健康程度。

计费规则

消息跨集群复制功能当前免费;在开始收费前,腾讯云会提前一个月多次通过站内信、短信和邮件等形式通知客户。

操作步骤

创建任务

进入消息队列 RocketMQ 版控制台,单击左侧导航栏跨集群复制 > 新建任务, 按照要求填写以下字段:
任务类型:选择 Topic 跨集群复制
任务名称:200字符以内,只能包含 中文、数字、字母、“-”和“_”;
源 Topic:通过下拉依次选择地域、集群、命名空间和 Topic,如果找不到需要的集群或 Topic 可以在集群列表页进行新建。
目标 Topic:通过下拉依次选择地域、集群、命名空间和 Topic,如果找不到需要的集群或 Topic 可以在集群列表页进行新建。
过滤类型:支持 TAG 过滤和 SQL 过滤两个方式。
复制起始位置:支持从最新的位点开始复制或者指定时间点开始复制。
是否立即开启任务:如果打开开关,在任务创建完成后就按照当前任务的配置进行复制。

单击创建任务后,会跳转到任务列表页,在任务初始化后即创建完成。
您创建的复制任务是单向的,即如果您创建一个 Topic A 到 Topic B 的复制任务,Topic A 的消息会自动复制到 Topic B;如果您需要双向的复制任务,您需要再次新建一个从 Topic B 到 Topic A 的复制任务。

复制任务

为了方便消息复制任务的创建,您也可以通过复制已有任务的配置快速创建新的任务。
进入消息队列 RocketMQ 版控制台,单击左侧导航栏跨集群复制,选择已创建的任务,单击操作列的新建类似,创建任务的页面会自动填充复制任务的相同参数,只需要简单修改后即可创建新的任务(目前控制台不得创建完全相同配置的任务)。

查看任务详情

在任务创建完成后,您可以在任务的列表页看到新增的复制任务,同时可以快速查看任务的状态。单击操作列的启动/暂停可以快速的开启和暂停任务。
运行中的任务不能修改配置信息,如果要修改复制任务的配置,请先暂停任务后,单击操作栏的编辑,或者进入任务详情页,单击“基本信息”右上角的编辑,修改任务的信息。
您可以单击任务名称,进入任务详情页查看任务的详细配置,例如过滤规则和起始时间等等。 在监控部分,您可以查看当前消息复制任务的实时监控,例如源消息消费总条数、消息复制失败条数、消息同步延迟等。


异常处理

正常情况下,状态栏会展示 “运行中” 或者 “已暂停” 的状态;如果状态为 “启动失败”,您需要检查任务运行状态和任务详细配置是否正确,例如 SQL 表达式是否正确等;鼠标悬浮在失败状态上会有具体的失败原因。

如果任务状态失败,您可以单击操作栏的编辑,或者进入任务详情页,单击“基本信息”右上角的编辑,重新更正任务的信息。

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈