云消息队列 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时,Group列表必须符合模板要求,具体规范,请参见4.x Group列表模板。
Group导出
登录云消息队列 RocketMQ 版控制台,在左侧导航栏单击实例列表。
在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。
在左侧导航栏单击Group 管理。
在Group 管理页面右上角单击图标。
系统会自动将该实例下的Group资源列表数据导出并保存为.xlsx文件。
Group导入
您可以将已导出的Group列表直接导入至目标实例中,也可以根据实际需求更新列表内容再导入Group信息。
登录云消息队列 RocketMQ 版控制台,在左侧导航栏单击实例列表。
在顶部菜单栏选择地域,如华东1(杭州),然后在实例列表中,单击目标实例名称。
在左侧导航栏单击Group 管理。
在Group 管理页面右上角单击图标。
选择在本地保存的Group资源列表文件,然后单击打开。
待导入的Group资源列表的模板规范如下:
模板参数
说明
取值限制
ConsumerGroupId
Group ID。
字符限制:推荐以“GID_”或“GID-”开头,支持字母a~z或A~Z、数字0~9以及下划线(_)和短划线(-)。
长度限制:2~64个字符。
ConsumerGroupType
Group的协议类型。
云消息队列 RocketMQ 版支持HTTP协议和TCP协议的Group ID,不同类型的Group ID不能混用。例如,使用TCP协议的SDK收发消息,则您需要创建TCP协议Group ID。
取值如下:
TCP
HTTP
Remark
Group的备注信息。
长度限制为1~60字符。
模板内容示例如下:
ConsumerGroupId
ConsumerGroupType
Remark
GID_test1
HTTP
HTTP协议的Group
GID_test2
TCP
TCP协议的Group
在弹出的导入资源列表面板中,选中待导入的Group,在其操作列单击确认并导入。
您也可以选中多个Group,然后单击批量导入。
导入成功后,Group列表中执行结果列变为已导入。
在导入资源列表面板左下角单击确定完成导入。
导入完成后,选中的待导入的Group会出现在Group列表中。
相关文档
如果您需要同时跨实例同步Topic的列表信息,请参见Topic导入/导出。
如果您需要迁移自建RockketMQ集群的数据到阿里云的云消息队列 RocketMQ 版上,请参见自建RocketMQ集群迁移上云。