集群迁移是消息队列 Kafka版提供的 Kafka 集群（实例）迁移服务，用于将您的自建 Kafka 实例元数据，或者兼容开源 Kafka 协议的各类 Kafka 实例元数据迁移至火山引擎消息队列 Kafka版实例。本文档介绍集群迁移的功能概述、注意事项以及使用流程。

集群迁移功能提供元数据迁移能力，支持迁移的元数据包括 Topic 和 Group 配置信息。在迁移过程中，系统提供幂等性支持，确保迁移数据的准确性和完整性。在迁移完成后，系统可自动解析迁移成功的元数据，并在目标 Kafka 实例中创建相应 Topic 和 Group。
根据您本地执行环境网络情况，消息队列 Kafka版提供以下 2 种迁移方案：

• 在线迁移
  当您的本地执行环境可访问公网时，使用此迁移方案。使用迁移工具在线迁移元数据。
• 离线迁移
  当您的本地执行环境无法访问公网时，使用此迁移方案。使用迁移工具导出元数据，再将导出的元数据导入至目标 Kafka 实例。

• 目标 Kafka 实例的状态：运行中。
• 单次可迁移的 Topic 分区总数：不超过目标 Kafka 实例可用分区数。

在进行迁移操作前，确保目标 Kafka 实例中分区数量充足，分区数量不足时，将无法执行迁移。若分区数量不足，请购买分区，若分区数量已达当前规格的最大额度，请升级实例规格。各计算规格对应的分区额度，参见产品规格，查看 Kafka 实例剩余可用分区数量的操作方法，参见查看实例详情。