Group导入/导出

云消息队列 RocketMQ 版支持将指定实例的Group列表信息导出,再导入至其他的云消息队列 RocketMQ 版实例,实现Group的跨实例迁移。你可以在更换实例或者克隆实例时,使用Group导入/导出功能快速批量创建出相同的Group。

背景信息

您可以在以下场景使用Group导入或导出功能:

  • 更换实例

    若当前实例不满足您的要求需要使用新的实例,您可以将当前实例的Group列表导出,然后再导入至新购买的实例,可在新的实例自动创建出相同的Group。

  • 克隆实例

    开发、测试、以及生产环境需要使用不同的实例进行部署,但业务访问的Group相同。您可以在其中一个实例中创建相关的Group,并导出Group列表,其他实例则可以通过导入该Group列表快速创建相同的Group。

注意事项

  • 4.x和5.x系列实例的Group元数据有所差异,因此:

    • 5.x系列实例的Group导入4.x系列实例时:导入操作可以执行;Group导入成功后,仅部分元数据生效,具体生效字段,以4.x的Group列表模板为准。

    • 4.x系列实例的Group导入5.x系列实例时:导入操作不可执行,您需要按照5.x实例的Group列表模板修改待导入的Group列表才能成功导入。

  • Group导入或导出操作仅涉及Group资源的基础信息,例如,Group ID、消费策略、Group的描述信息等,不涉及订阅关系和消息数据的变更或迁移。

  • 导入Group时,Group列表必须符合模板要求,具体规范,请参见5.x Group列表模板

Group导出

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

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

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

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

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

Group导入

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

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

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

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

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

  5. 选择在本地保存的Group资源列表文件,然后单击打开

    待导入的Group资源列表的模板规范如下:

    模板参数

    说明

    取值限制

    ConsumerGroupId

    Group ID

    • 字符限制:支持字母a~z或A~Z、数字0~9以及下划线(_)和短划线(-)。

    • 长度限制:1~60个字符。

    Group ID不能使用保留字符或特殊前缀字符命名,具体限制,请参见参数限制

    DeliveryOrderType

    消费者消费消息时,云消息队列 RocketMQ 版向消费者客户端投递消息的顺序性。

    取值如下:

    • Concurrently:并发投递

    • Orderly:顺序投递

    更多信息,请参见消费顺序

    ConsumeRetryPolicy

    消费者消费消息失败时,系统的重试策略。

    取值如下:

    • FixedRetryPolicy:固定间隔重试

    • DefaultRetryPolicy:阶梯退避重试

    更多信息,请参见消费重试

    MaxRetryTimes

    最大重试次数

    不超过1000次。

    DeadLetterTargetTopic

    死信Topic

    • 死信Topic不能和原消息发送Topic相同。

    • 若不需要使用死信消息功能,该参数可以为空。

    更多信息,请参见死信消息

    Remark

    Group的备注信息。

    长度限制为1~60字符。

    模板内容示例如下:

    ConsumerGroupId

    DeliveryOrderType

    ConsumeRetryPolicy

    MaxRetryTimes

    DeadLetterTargetTopic

    Remark

    testgroup1

    Orderly

    FixedRetryPolicy

    16

    用于订阅账单消息

    testgroup2

    Concurrently

    DefaultRetryPolicy

    16

    targettopic1

    用于订阅物流消息

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

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

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

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

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

相关文档