加载外部tsfile文件
介绍
加载外部tsfile文件工具允许用户向正在运行中的Apache IoTDB中加载、删除或移出tsfile文件。
使用方式
用户通过Cli工具或JDBC向Apache IoTDB系统发送指定命令实现文件加载的功能。
加载tsfile文件
加载tsfile文件的指令为:load "<path/dir>" [true/false] [storage group level]
该指令有两种用法:
- 通过指定文件路径(绝对路径)加载单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
- 通过指定文件夹路径(绝对路径)批量加载文件。
第二个参数表示待加载的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"