Apache IoTDB 0.13.2迁移至1.0.0/1.1.0方法及配置疑问

一、核心迁移方式：TSFile直接加载 #

你理解的方向是对的——可以直接将0.13.2版本生成的TSFile文件加载到1.0.0/1.1.0版本中，但需要遵循规范步骤：

1. 导出旧版本TSFile #

• 先停止0.13.2版本的IoTDB服务，避免数据写入导致文件损坏
• 找到0.13.2的数据存储目录（默认路径为data/datanode/data/），复制所有.tsfile后缀的数据文件以及对应的.resource元数据文件到新环境的临时目录，比如/tmp/old_iotdb_data/

2. 在新版本中加载TSFile #

• 启动1.0.0/1.1.0版本的IoTDB服务，确保服务正常运行
• 启动IoTDB CLI客户端（执行start-cli.sh或start-cli.bat），执行加载命令：

  LOAD '/tmp/old_iotdb_data/' WITH TIMESTAMP_PRECISION=ms;
  

  注：如果你的0.13.2实例使用的是微秒级时间戳，需将参数改为TIMESTAMP_PRECISION=us，0.13.2默认时间戳精度为毫秒，所以一般用ms即可。

• 等待加载完成，CLI会返回加载结果，确认所有文件加载成功（若有失败文件，需检查文件完整性后重新加载）

二、迁移后的关键配置调整 #

加载完成后，需要根据旧版本的配置习惯和新版本特性调整以下关键配置（配置文件为iotdb-datanode.properties）：

• 时间戳精度对齐：
  若旧版本使用了非默认的时间戳精度（比如微秒），需在新版本配置中明确设置：

  timestamp_precision=us
  

  修改后重启服务生效。

• 存储引擎选择（可选）：
  1.0.0+版本默认采用性能更优的MergeTree存储引擎，而0.13.2默认使用TsFile引擎。如果需要保持与旧版本一致的存储行为，可修改：

  storage_engine=TSFILE
  

  推荐优先使用MergeTree引擎以获得更好的查询和写入性能。

• 元数据缓存优化：
  如果旧库存在大量元数据，可调整元数据缓存大小提升查询效率：

  metadata_cache_size=1000000
  

  数值可根据服务器内存大小灵活调整。

• 权限配置迁移：
  若旧版本有自定义权限规则，将0.13.2的iotdb-authority.properties文件中的配置内容复制到新版本的对应文件中，重启服务后权限规则即可生效。

三、迁移验证与注意事项 #

• 迁移前务必备份0.13.2的所有数据和配置文件，防止数据丢失
• 加载TSFile时，确保新版本服务器磁盘空间至少为旧数据大小的1.5倍
• 加载完成后，执行全量范围查询（比如SELECT * FROM root.** WHERE time >= start_time AND time <= end_time），对比旧库数据验证完整性
• 集群部署场景下，需在每个数据节点上加载对应分片的TSFile，或使用1.0.0+支持的集群级LOAD命令统一加载

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