如何迁移Apache IoTDB 0.12.5数据至1.1.0集群版本？是否需导出TSFile？

版本兼容性说明 #

0.12.5版本的数据不能直接迁移至1.1.0集群版本。两个版本跨度较大，存储格式、元数据模型以及集群架构逻辑存在显著差异，直接拷贝数据文件或进行跨版本升级会导致元数据解析失败、数据损坏等问题。

推荐迁移方案：TSFile导出+Load命令导入 #

是的，需要通过导出0.12.5版本的所有TSFile，再使用Load命令完成数据迁移，具体步骤如下：

1. 从0.12.5环境导出TSFile #

• 先停止0.12.5的IoTDB服务，避免导出过程中有新数据写入导致文件不一致
• 使用官方提供的export-tsfile工具导出所有TSFile：

  # 单机版本执行（Linux）
  ./export-tsfile.sh -d <导出目录路径> -r <根存储组名称>
  # 单机版本执行（Windows）
  ./export-tsfile.bat -d <导出目录路径> -r <根存储组名称>
  # 集群版本需在每个DataNode节点单独执行导出，或使用集群批量导出脚本
  

• 导出完成后，检查所有TSFile文件是否完整，无损坏。

2. 准备1.1.0集群环境 #

• 完成1.1.0集群的部署与初始化，确保集群状态正常
• 预先在1.1.0集群中创建对应存储组与时间序列元数据：
  • 从0.12.5导出元数据：

    ./export-metadata.sh -o <元数据输出文件路径>
    

  • 在1.1.0集群导入元数据：

    ./import-metadata.sh -i <元数据文件路径>
    

3. 将TSFile加载至1.1.0集群 #

• 将导出的TSFile上传至1.1.0集群的任意节点，或集群可访问的共享存储目录
• 使用IoTDB客户端执行LOAD命令导入数据：

  LOAD '<TSFile文件路径或目录>' WITH STORAGE GROUP '<目标存储组>';
  

• 批量导入可编写脚本循环执行上述命令，或使用集群批量加载工具提升效率。

关键注意事项 #

• 导出前必须停止0.12.5的写入服务，保证TSFile数据一致性
• 导入前确认1.1.0集群的存储组配置与源版本匹配，避免数据路由错误
• 导入完成后，需随机查询部分时间序列数据，对比源版本与目标版本的结果，校验数据完整性

内容的提问来源于stack exchange，提问作者NKZ