在应用迁移上云或实例备份等场景下,如果需要一次性创建多个 Topic,可以通过控制台上传配置文件的方式批量创建 Topic。本文档介绍批量导入 Topic 的操作步骤。
背景信息
在应用迁移上云或实例备份等场景下,需要在新实例中创建一批和源端 Topic 配置相同的 Topic,例如相同的 Topic 名称、分区数量、消息保存时间等配置。消息队列 Kafka版支持通过控制台上传配置文件的方式批量创建 Topic。您可以根据指定格式的模板文件准备好 Topic 的配置文件,并将其上传到消息队列 Kafka版控制台中,后端服务会自动为您创建指定配置的 Topic。
注意事项
- 仅支持上传 csv 格式的配置文件。且文件长度最大为 10MB。
- 每次最多批量导入 200 条 Topic 配置,即每次最多批量创建 200 个 Topic。
前提条件
在控制台批量导入 Topic 之前,需要根据控制台提供的配置模板准备配置文件,配置文件中应包含 Topic 名称等配置信息。
您可以在 Topic 列表页面单击批量导入 Topic,并根据页面提示下载配置模板,在配置模板中填写待导入的 Topic 信息即可。
说明
- 配置文件中,每一列配置均为必选,否则上传时模板解析失败。但描述与用户权限可设置为空,表示没有描述信息、没有自定义权限。
- 参数配置应符合填写要求,详细的规则说明请参考模板标题行。
操作步骤
- 登录消息队列 Kafka版控制台。
- 在顶部菜单栏中选择地域,并在左侧导航栏中单击实例列表。
- 找到目标实例,单击实例名称。
- 在页签栏中单击Topic管理。
- 单击批量导入Topic。
- 根据页面提示上传配置文件。
- 如果页面提示文件配置校验通过,说明配置文件可被正确解析。继续执行后续操作。
- 如果页面提示文件数据校验失败,请根据提示修改,说明配置文件填写有误,请根据页面提示修改部分参数配置,并再次上传配置文件。
- 单击创建导入任务。
后端服务会根据上传的配置文件批量创建 Topic,并同时创建一个后台任务以供查看任务执行的相关信息。
- 如果 Topic 状态由创建中变更为服务中,表示 Topic 创建成功,可以开始使用。
- 如果 Topic 长期处于创建中状态或出现其他异常情况,可以在后台任务管理页签中查看任务执行的详细信息。