在应用迁移上云或实例备份等场景下,如果需要一次性创建多个 Topic,可以通过控制台上传配置文件的方式批量创建 Topic。本文档介绍批量导入 Topic 的操作步骤。
背景信息
在应用迁移上云或实例备份等场景下,需要在新实例中创建一批和源端 Topic 配置相同的 Topic,例如相同的 Topic 名称、描述、队列数、消息类型。
消息队列 RocketMQ版支持通过控制台上传模板文件的方式批量创建 Topic。您可以从控制台上下载 Topic 模板文件,然后根据格式填写 Topic 信息,并将其上传到控制台中,上传后系统将解析文件,利用文件中的配置完成 Topic 创建。
注意事项
- 仅支持上传 csv 格式的配置文件。且文件长度最大为 10MB。
- 每次最多批量导入 200 条 Topic 配置,即每次最多批量创建 200 个 Topic。
- 批量导入 Topic 时,不支持同时导入密钥权限,即不能同时添加指定密钥对于此 Topic 的自定义权限。若有相关需求,建议成功导入 Topic 之后手动为其添加密钥权限。
前提条件
在控制台批量导入 Topic 之前,需要根据控制台提供的模板文件填写 Topic 信息。
您可以在 Topic 列表页面单击批量导入 Topic,并根据页面提示下载模板文件,在模板文件中填写待导入的 Topic 信息。
说明
- 模板文件中,Topic 名称与队列数为必选,否则上传时模板解析失败。其余参数为可选,消息类型默认设置为 0,表示普通消息。
- 参数配置应符合填写要求,详细的填写规则说明请参考模板标题行。每个参数的概念说明请参考创建 Topic。
操作步骤
- 登录消息队列 RocketMQ版控制台。
- 在顶部菜单栏中选择地域,并在左侧导航栏中单击实例列表。
- 找到目标实例,单击实例名称。
- 在页签栏中单击Topic管理。
- 单击批量导入Topic。
- 根据页面提示上传配置文件。
- 如果页面提示文件数据校验通过,说明配置文件可被正确解析。继续执行后续操作。
- 如果页面提示文件数据校验失败,请根据提示修改,说明配置文件填写有误,请根据页面提示修改指定的参数配置,并再次上传配置文件。
- 单击创建导入任务。
后端服务会根据上传的模板文件批量创建 Topic,并同时创建一个后台任务以供查看任务执行的相关信息。如果 Topic 出现其他异常情况,可以在后台任务管理页签中中查看任务执行的详细信息。