You need to enable JavaScript to run this app.
导航

批量导入 Topic

最近更新时间2023.07.04 21:17:29

首次发布时间2023.07.04 21:17:29

在应用迁移上云或实例备份等场景下,如果需要一次性创建多个 Topic,可以通过控制台上传配置文件的方式批量创建 Topic。本文档介绍批量导入 Topic 的操作步骤。

背景信息

在应用迁移上云或实例备份等场景下,需要在新实例中创建一批和源端 Topic 配置相同的 Topic,例如相同的 Topic 名称、描述、队列数、消息类型。消息队列 RocketMQ版支持通过控制台上传配置文件的方式批量创建 Topic。您可以根据指定格式的模板文件准备好 Topic 的配置文件,并将其上传到消息队列 RocketMQ版控制台中,后端服务会自动为您创建指定配置的 Topic。

注意事项

  • 上传后系统将解析文件,利用文件中的配置并完成 Topic 创建。
  • 仅支持上传 csv 格式的配置文件。且文件长度最大为 10MB。
  • 每次最多批量导入 200 条 Topic 配置,即每次最多批量创建 200 个 Topic。
  • 批量导入 Topic 时,不支持同时导入密钥权限,即不能同时添加指定密钥对于此 Topic 的自定义权限。若有相关需求,建议成功导入 Topic 之后手动为其添加密钥权限。

前提条件

在控制台批量导入 Topic 之前,需要根据控制台提供的配置模板准备配置文件,配置文件中应包含 Topic 名称等配置信息。
您可以在 Topic 列表页面单击批量导入 Topic,并根据页面提示下载配置模板,在配置模板中填写待导入的 Topic 信息即可。

说明

  • 配置文件中,Topic 名称与队列数为必选,否则上传时模板解析失败。其余参数为可选,消息类型默认设置为 0,表示普通消息。
  • 参数配置应符合填写要求,详细的填写规则说明请参考模板标题行。每个参数的概念说明请参考创建 Topic

操作步骤

  1. 登录消息队列 RocketMQ版控制台
  2. 在顶部菜单栏中选择地域,并在左侧导航栏中单击实例列表
  3. 找到目标实例,单击实例名称。
  4. 在页签栏中单击Topic管理
  5. 单击批量导入Topic
  6. 根据页面提示上传配置文件。
    • 如果页面提示文件配置校验通过,说明配置文件可被正确解析。继续执行后续操作。
    • 如果页面提示文件数据校验失败,请根据提示修改,说明配置文件填写有误,请根据页面提示修改指定的参数配置,并再次上传配置文件。
  7. 单击创建导入任务。
    后端服务会根据上传的配置文件批量创建 Topic,并同时创建一个后台任务以供查看任务执行的相关信息。如果 Topic 状态由 创建中 变更为 服务中 ,表示 Topic 创建成功,可以开始使用。如果 Topic 长期处于 创建中 状态或出现其他异常情况,可以在后台任务管理页签中中查看任务执行的详细信息。