云消息队列 RocketMQ 版支持将指定实例的Group列表信息导出,再导入至其他的云消息队列 RocketMQ 版实例,实现Group的跨实例迁移。你可以在更换实例或者克隆实例时,使用Group导入/导出功能快速批量创建出相同的Group。
背景信息
您可以在以下场景使用Group导入或导出功能:
更换实例
若当前实例不满足您的要求需要使用新的实例,您可以将当前实例的Group列表导出,然后再导入至新购买的实例,可在新的实例自动创建出相同的Group。
克隆实例
开发、测试、以及生产环境需要使用不同的实例进行部署,但业务访问的Group相同。您可以在其中一个实例中创建相关的Group,并导出Group列表,其他实例则可以通过导入该Group列表快速创建相同的Group。
注意事项
4.x和5.x系列实例的Group元数据有所差异,因此:
Group导入或导出操作仅涉及Group资源的基础信息,例如,Group ID、消费策略、Group的描述信息等,不涉及订阅关系和消息数据的变更或迁移。
导入Group时,Group列表必须符合模板要求,具体规范,请参见5.x Group列表模板。
Group导出
登录云消息队列 RocketMQ 版控制台,在左侧导航栏单击实例列表。
在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。
在左侧导航栏单击Group 管理。
在Group 管理页面右上角单击图标。
系统会自动将该实例下的Group资源列表数据导出并保存为.xlsx文件。
Group导入
您可以将已导出的Group列表直接导入至目标实例中,也可以根据实际需求更新列表内容再导入Group信息。
登录云消息队列 RocketMQ 版控制台,在左侧导航栏单击实例列表。
在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。
在左侧导航栏单击Group 管理。
在Group 管理页面右上角单击图标。
选择在本地保存的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
用于订阅物流消息
在弹出的导入资源列表面板中,选中待导入的Group,在其操作列单击确认并导入。
您也可以选中多个Group,然后单击批量导入。
导入成功后,Group列表中执行结果列变为已导入。
在导入资源列表面板左下角单击确定完成导入。
导入完成后,选中的待导入的Group会出现在Group列表中。
相关文档
如果您需要同时跨实例同步Topic的列表信息,请参见Topic导入/导出。
如果您需要迁移自建RockketMQ集群的数据到阿里云的云消息队列 RocketMQ 版上,请参见自建RocketMQ集群迁移上云。