本文为您介绍如何导出或导入Group资源列表实现跨实例Group源数据的迁移。

背景信息

云消息队列 RocketMQ 版支持将指定实例的Group资源列表信息导出，并导入至其他的云消息队列 RocketMQ 版实例中，您可以在以下场景使用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资源列表的模板规范如下：
    模板参数说明取值限制
    ConsumerGroupIdGroup ID。
    • 字符限制：推荐以“GID_”或“GID-”开头，支持字母a~z或A~Z、数字0~9以及下划线（_）和短划线（-）。
    • 长度限制：2～64个字符。
    ConsumerGroupTypeGroup的协议类型。

    云消息队列 RocketMQ 版支持HTTP协议和TCP协议的Group ID，不同类型的Group ID不能混用。例如，使用TCP协议的SDK收发消息，则您需要创建TCP协议Group ID。

    		取值如下：
    • TCP
    • HTTP
    RemarkGroup的备注信息。长度限制为1~60字符。
    模板内容示例如下：
    ConsumerGroupIdDeadLetterTargetTopicRemark
    GID_test1HTTPHTTP协议的Group
    GID_test2TCPTCP协议的Group
  6. 在弹出的导入资源列表面板中，选中待导入的Group，在其操作列单击确认并导入。

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

    导入成功后，Group列表中执行结果列变为已导入。
  7. 在导入资源列表面板左下角单击确定完成导入。