本文介绍如何在消息队列RocketMQ版控制台将开源RocketMQ的元数据迁移到消息队列RocketMQ版实例。

背景信息

元数据迁移指的是将开源RocketMQ的Topic和Group的配置信息迁移到消息队列RocketMQ版上,并不会迁移Topic中的消息数据。

消息队列RocketMQ版提供元数据导出工具,支持将开源RocketMQ的元数据导出为一份JSON文件,然后通过消息队列RocketMQ版控制台导入至消息队列RocketMQ版上的目标实例。消息队列RocketMQ版会根据元数据文件中的配置信息在目标实例中创建对应的Topic和Group,消息队列RocketMQ版创建的Topic和Group的名称及数量和开源RocketMQ集群下的一致。

前提条件

  • 已导入需要迁移的开源RocketMQ集群的元数据文件并创建好迁移任务。具体操作,请参见步骤一:创建迁移任务
  • 已完成迁移评估。具体操作,请参见步骤二:迁移评估
  • 根据评估结果已准备好一个符合要求的消息队列RocketMQ版实例作为迁移的目标实例。若未创建实例,请参见实例管理创建。

迁移元数据

  1. 登录消息队列RocketMQ版控制台
  2. 在左侧导航栏单击迁移上云
  3. 在顶部菜单栏,选择地域,如华东1(杭州)
  4. 迁移上云任务列表中选择指定的任务,在其操作列单击详情
  5. 迁移元数据配置向导页面的目标实例下拉菜单中,选择已创建好的消息队列RocketMQ版实例作为元数据导入的目标实例,并单击确认
    此时所有的Group元数据已经在后台完成自动导入,界面只显示所有Topic的资源列表,您需要完成所有Topic类型的订正及导入操作后才能查看所有资源的导入结果。
  6. 完成所有Topic消息类型的订正和导入操作,然后单击页面下方的确认
    1. 在资源列表中选择指定的Topic资源,在其消息类型列的下拉菜单中选择Topic类型,然后在其操作列单击确认并导入;您也可以选中多个Topic,确认完所有选中Topic的类型后,单击页面左下角的批量确认并导入
    2. 在弹出的提示对话框中单击确认
    资源列表中将显示所有Topic和Group的信息及迁移结果。您可以在资源列表上方的迁移详情区域查看所有资源的迁移结果总览。您也可以根据资源名称、资源类型或执行结果进行过滤,查看指定资源的迁移结果。

结果验证

若迁移成功,则目标消息队列RocketMQ版实例下会创建好对应的Topic和Group。您可以在Topic 管理Group 管理页面的资源列表中查看。

  1. 登录消息队列RocketMQ版控制台
  2. 在左侧导航栏,单击实例列表
  3. 在顶部菜单栏,选择地域,如华东1(杭州)
  4. 实例列表页面,选择指定的实例并单击实例名称或在其操作列单击详情
  5. 在左侧导航栏单击Topic 管理,在Topic列表中查看是否已存在对应Topic。
  6. 在左侧导航栏单击Group 管理,在Group列表中查看是否已存在对应的Group。

失败原因说明

若迁移失败,资源列表中会显示迁移失败的可能原因。
可能原因 说明
您指定的Topic已存在。 目标实例下已存在和待创建Topic名称相同的Topic。
您请求创建的Group ID已存在,请确认。 目标实例下已存在和待创建Group ID相同的Group。
指定的实例不存在 请在实例列表页面查看目标实例是否存在。
实例权限验证失败。请确认实例权限信息后再试。 请确认目标实例的所属权限。
指定的实例不在服务中 请在实例列表页面查看目标实例的状态信息。
无法创建 Topic,该实例的 Topic 数量已达容量上限,请前往铂金版实例管理页面进行规格升级。 目标实例下的Topic数量已达到最大上限,请删除不再使用的Topic,或对该实例进行升配操作。
实例没有相关权限 请检查实例的所属权限和授权策略。
Topic不能和Group重名。 Topic名称和Group ID不能重名。
Group不能和Topic重名。 Topic名称和Group ID不能重名。
您指定的 Group ID 属于其他实例。 其他实例下已存在和待创建Group ID相同的Group。
创建 Group ID 失败。请稍后再试。 创建Group ID失败,请稍后重试或提交工单联系技术支持人员。
创建Topic失败。 Topic创建失败,请稍后重试或提交工单联系技术支持人员。
系统处理错误,请联系系统管理员。 系统错误,请提交工单联系技术支持人员。
参数验证失败 参数缺失或者传入值非法,请提交工单联系技术支持人员。

后续步骤

步骤四:迁移消息服务