文档中心

消息队列 Kafka版

Topic 管理

批量导入 Topic

在应用迁移上云或实例备份等场景下，如果需要一次性创建多个 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 长期处于创建中状态或出现其他异常情况，可以在后台任务管理页签中查看任务执行的详细信息。

最近更新时间：2025.06.27 14:59:10

这个页面对您有帮助吗？

有用

无用