文档

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时,Group列表必须符合模板要求,具体规范,请参见4.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。

    • 字符限制:推荐以“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

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

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

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

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

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

相关文档