加载外部tsfile文件

介绍

加载外部tsfile文件工具允许用户向正在运行中的Apache IoTDB中加载、删除或移出tsfile文件。

使用方式

用户通过Cli工具或JDBC向Apache IoTDB系统发送指定命令实现文件加载的功能。

加载tsfile文件

加载tsfile文件的指令为：load "<path/dir>" [true/false] [storage group level]

该指令有两种用法：

  1. 通过指定文件路径(绝对路径)加载单tsfile文件。

第二个参数表示待加载的tsfile文件的路径，其中文件名称需要符合tsfile的命名规范，即{systemTime}-{versionNum}-{mergeNum}.tsfile。第三、四个参数为可选项。当待加载的tsfile文件中时间序列对应的元数据不存在时，用户可以选择是否自动创建schema，参数为true表示自动创建schema，相反false表示不创建，缺省时默认创建schema。当tsfile对应的存储组不存在时，用户可以通过第四个参数来制定存储组的级别，默认为iotdb-engine.properties中设置的级别。若待加载的tsfile文件对应的.resource文件存在，会被一并加载至Apache IoTDB数据文件的目录和引擎中，否则将通过tsfile文件重新生成对应的.resource文件，即加载的tsfile文件所对应的.resource文件不是必要的。

示例：

  • load "/Users/Desktop/data/1575028885956-101-0.tsfile"
  • load "/Users/Desktop/data/1575028885956-101-0.tsfile" false
  • load "/Users/Desktop/data/1575028885956-101-0.tsfile" true
  • load "/Users/Desktop/data/1575028885956-101-0.tsfile" true 1
  1. 通过指定文件夹路径(绝对路径)批量加载文件。

第二个参数表示待加载的tsfile文件的路径，其中文件名称需要符合tsfile的命名规范，即{systemTime}-{versionNum}-{mergeNum}.tsfile。第三、四个参数为可选项。当待加载的tsfile文件中时间序列对应的元数据不存在时，用户可以选择是否自动创建schema，参数为true表示自动创建schema，相反false表示不创建，缺省时默认创建schema。当tsfile对应的存储组不存在时，用户可以通过第四个参数来制定存储组的级别，默认为iotdb-engine.properties中设置的级别。若待加载文件对应的.resource文件存在，则会一并加载至Apache IoTDB数据文件目录和引擎中，否则将通过tsfile文件重新生成对应的.resource文件，即加载的tsfile文件所对应的.resource文件不是必要的。

示例：

  • load "/Users/Desktop/data"
  • load "/Users/Desktop/data" false
  • load "/Users/Desktop/data" true
  • load "/Users/Desktop/data" true 1

删除tsfile文件

删除tsfile文件的指令为：remove "<path>"

该指令通过指定文件路径删除tsfile文件，具体做法是将该tsfile和其对应的.resource和.modification文件全部删除。

示例：

  • remove "root.vehicle/1575028885956-101-0.tsfile"
  • remove "1575028885956-101-0.tsfile"

移出tsfile文件至指定目录

移出tsfile文件的指令为：remove "<path>" "<dir>"

该指令将指定路径的tsfile文件移动至目标文件夹(绝对路径)中，具体做法是在引擎中移除该tsfile，并将该tsfile文件和其对应的.resource文件移动到目标文件夹下

示例：

  • move "root.vehicle/1575029224130-101-0.tsfile" "/data/data/tmp"
  • move "1575029224130-101-0.tsfile" "/data/data/tmp"