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

批量导入 Topic

最近更新时间2023.12.11 21:55:05

首次发布时间2023.06.27 15:34:21

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

背景信息

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

注意事项

  • 仅支持上传 csv 格式的配置文件。且文件长度最大为 10MB。
  • 每次最多批量导入 200 条 Topic 配置,即每次最多批量创建 200 个 Topic。

前提条件

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

说明

  • 配置文件中,每一列配置均为必选,否则上传时模板解析失败。但描述与用户权限可设置为空,表示没有描述信息、没有自定义权限。
  • 参数配置应符合填写要求,详细的规则说明请参考模板标题行。

操作步骤

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