云消息队列 RocketMQ 版支持将指定实例的Topic列表信息导出,再导入至其他的云消息队列 RocketMQ 版实例,实现Topic的跨实例迁移。您可以在更换实例或者克隆实例时,使用Topic导入/导出功能快速批量创建出相同的Topic。
背景信息
云消息队列 RocketMQ 版支持将指定实例的Topic资源列表信息导出,并导入至其他的云消息队列 RocketMQ 版实例中,您可以在以下场景使用Topic导入或导出功能:
更换实例
若当前实例不满足您的要求需要使用新的实例,例如,从4.x实例变更为5.x实例,您可以将4.x实例的Topic列表导出,然后再导入至新的5.x实例,在5.x实例中可自动创建出相同的Topic。
克隆实例
开发、测试、以及生产环境需要使用不同的实例进行部署,但业务访问的Topic相同。您可以在其中一个实例中创建相关的Topic,并导出Topic列表,其他实例则可以通过导入该Topic列表快速创建相同的Topic。
注意事项
Topic导入或导出支持跨实例系列,例如,您可以将4.x系列实例的Topic列表导出然后导入至5.x系列的实例中。
Topic导入或导出操作仅涉及Topic资源的基础信息,例如,Topic名称、Topic的消息类型、Topic的描述信息,不涉及Topic中消息数据的变更或迁移。
导入Topic时,Topic列表必须符合模板要求,具体规范,请参见Topic列表模板。
Topic导出
登录云消息队列 RocketMQ 版控制台,在左侧导航栏单击实例列表。
在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。
在左侧导航栏单击Topic 管理。
在Topic 管理页面右上角单击图标。
系统会自动将该实例下的Topic资源列表数据导出并保存为.xlsx文件。
Topic导入
您可以将已导出的Topic列表直接导入至目标实例中,也可以根据实际需求更新列表内容再导入Topic信息。
登录云消息队列 RocketMQ 版控制台,在左侧导航栏单击实例列表。
在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。
在左侧导航栏单击Topic 管理。
在Topic 管理页面右上角单击图标。
选择在本地保存的Topic资源列表文件,然后单击打开。
待导入的Topic资源列表的模板规范如下:
模板参数
说明
取值限制
TopicName
Topic名称。
字符限制:支持字母a~z或A~Z、数字0~9以及下划线(_)和短划线(-)。
长度限制:1~60个字符。
Topic不能使用保留字符或特殊前缀字符命名,具体限制,请参见参数限制。
MessageType
Topic的消息类型。
取值如下:
TRANSACTION:事务消息
DELAY:定时/延时消息
FIFO:顺序消息
NORMAL:普通消息
Remark
Topic的备注信息。
长度限制为1~60字符。
模板内容示例如下:
TopicName
MessageType
Remark
Topic1
TRANSACTION
用于发送事务消息
Topic2
NORMAL
用于发送普通消息
Topic3
DELAY
用于发送延时消息
在弹出的导入资源列表面板中,选中待导入的Topic,在其操作列单击确认并导入。
您也可以选中多个Topic,然后单击批量导入。
导入成功后,Topic列表中执行结果列变为已导入。
在导入资源列表面板左下角单击确定完成导入。
导入完成后,选中的待导入的Topic会出现在Topic列表中。
相关文档
如果您需要同时跨实例同步Topic的列表信息,请参见Group导入/导出。
如果您需要迁移自建RockketMQ集群的数据到阿里云的云消息队列 RocketMQ 版上,请参见自建RocketMQ集群迁移上云。