Topic导入/导出

云消息队列 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导出

  1. 登录云消息队列 RocketMQ 版控制台,在左侧导航栏单击实例列表

  2. 在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。

  3. 在左侧导航栏单击Topic 管理

  4. Topic 管理页面右上角单击导出图标。

    系统会自动将该实例下的Topic资源列表数据导出并保存为.xlsx文件。

Topic导入

您可以将已导出的Topic列表直接导入至目标实例中,也可以根据实际需求更新列表内容再导入Topic信息。

  1. 登录云消息队列 RocketMQ 版控制台,在左侧导航栏单击实例列表

  2. 在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。

  3. 在左侧导航栏单击Topic 管理

  4. Topic 管理页面右上角单击导入图标。

  5. 选择在本地保存的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

    用于发送延时消息

  6. 在弹出的导入资源列表面板中,选中待导入的Topic,在其操作列单击确认并导入

    您也可以选中多个Topic,然后单击批量导入

    导入成功后,Topic列表中执行结果列变为已导入

  7. 导入资源列表面板左下角单击确定完成导入。

    导入完成后,选中的待导入的Topic会出现在Topic列表中。

相关文档