| import{_ as o,r as a,o as i,c as r,b as t,d as e,a as d,e as l}from"./app-Bp5kEZWW.js";const c={},p=l('<h2 id="加载-tsfile" tabindex="-1"><a class="header-anchor" href="#加载-tsfile"><span>加载 TsFile</span></a></h2><h3 id="介绍" tabindex="-1"><a class="header-anchor" href="#介绍"><span>介绍</span></a></h3><p>加载外部 tsfile 文件工具允许用户向正在运行中的 Apache IoTDB 中加载、删除或移出 tsfile 文件。</p><h3 id="使用方式" tabindex="-1"><a class="header-anchor" href="#使用方式"><span>使用方式</span></a></h3><p>用户通过 Cli 工具或 JDBC 向 Apache IoTDB 系统发送指定命令实现文件加载的功能。</p><h4 id="加载-tsfile-文件" tabindex="-1"><a class="header-anchor" href="#加载-tsfile-文件"><span>加载 tsfile 文件</span></a></h4><p>加载 tsfile 文件的指令为：<code>load '<path/dir>' [autoregister=true/false][,sglevel=int][,verify=true/false]</code></p><p>该指令有两种用法：</p><ol><li>通过指定文件路径(绝对路径)加载单 tsfile 文件。</li></ol><p>第二个参数表示待加载的 tsfile 文件的路径，其中文件名称需要符合 tsfile 的命名规范，即<code>{systemTime}-{versionNum}-{in_space_compaction_num}-{cross_space_compaction_num}.tsfile</code>。load 命令有三个可选项，分别是 autoregister，值域为 true/false，sglevel，值域为整数，verify，值域为 true/false。不同选项之间用逗号连接，选项之间无顺序要求。</p><p>AUTOREGISTER 选项表示当待加载的 tsfile 文件中时间序列对应的元数据不存在时，用户可以选择是否自动创建 schema ，参数为 true 表示自动创建 schema，相反 false 表示不创建，缺省时默认创建 schema。</p>',11),n=t("code",null,"iotdb-engine.properties",-1),f={href:"http://root.sg",target:"_blank",rel:"noopener noreferrer"},h=l('<p>VERIFY 选项表示是否对载入的 tsfile 中的所有时间序列进行元数据检查，默认为 true。开启时，若载入的 tsfile 中的时间序列在当前 iotdb 中也存在，则会比较该时间序列的所有 Measurement 的数据类型是否一致，如果出现不一致将会导致载入失败，关闭该选项会跳过检查，载入更快。</p><p>若待加载的 tsfile 文件对应的<code>.resource</code>文件存在，会被一并加载至 Apache IoTDB 数据文件的目录和引擎中，否则将通过 tsfile 文件重新生成对应的<code>.resource</code>文件，即加载的 tsfile 文件所对应的<code>.resource</code>文件不是必要的。</p><p>示例：</p><ul><li><code>load '/Users/Desktop/data/1575028885956-101-0.tsfile'</code></li><li><code>load '/Users/Desktop/data/1575028885956-101-0.tsfile' autoregister=false</code></li><li><code>load '/Users/Desktop/data/1575028885956-101-0.tsfile' autoregister=true</code></li><li><code>load '/Users/Desktop/data/1575028885956-101-0.tsfile' sglevel=1</code></li><li><code>load '/Users/Desktop/data/1575028885956-101-0.tsfile' verify=true</code></li><li><code>load '/Users/Desktop/data/1575028885956-101-0.tsfile' autoregister=true,sglevel=1</code></li><li><code>load '/Users/Desktop/data/1575028885956-101-0.tsfile' verify=false,sglevel=1</code></li><li><code>load '/Users/Desktop/data/1575028885956-101-0.tsfile' autoregister=false,verify=true</code></li><li><code>load '/Users/Desktop/data/1575028885956-101-0.tsfile' autoregister=false,sglevel=1,verify=true</code></li></ul><ol start="2"><li>通过指定文件夹路径(绝对路径)批量加载文件。</li></ol><p>第二个参数表示待加载的 tsfile 文件夹的路径，其中文件夹内所有文件名称需要符合 tsfile 的命名规范，即<code>{systemTime}-{versionNum}-{in_space_compaction_num}-{cross_space_compaction_num}.tsfile</code>。选项意义与加载单个 tsfile 文件相同。</p><p>示例：</p><ul><li><code>load '/Users/Desktop/data'</code></li><li><code>load '/Users/Desktop/data' autoregister=false</code></li><li><code>load '/Users/Desktop/data' autoregister=true</code></li><li><code>load '/Users/Desktop/data' autoregister=true,sglevel=1</code></li><li><code>load '/Users/Desktop/data' autoregister=false,sglevel=1,verify=true</code></li></ul><h4 id="远程加载" tabindex="-1"><a class="header-anchor" href="#远程加载"><span>远程加载</span></a></h4><p>通常情况下，文件路径必须是 IoTDB 实例所在机器的本地文件路径，在 IoTDB 0.13.5 及之后的版本中，文件路径新增支持 HTTP 风格的 URI，可以通过 HTTP 协议远程加载单个文件。格式为 <code>load 'http://host:port/filePath'</code>。</p><p>例如，如果您的 IoTDB 实例在 IP 地址为 168.121.0.1 的机器 A 上运行，您希望将 IP 地址为 168.121.0.2 机器 B 上的文件<code>/root/data/1-1-0-0.tsfile</code>加载进 IoTDB 实例，您需要按照以下步骤操作</p><ol><li>在机器 B 上启动 HTTP 服务，例如您可以使用 python 命令 <code>python -m http.server </code>来启动一个简单的 HTTP 服务。</li><li>使用 Cli 工具连接到机器 A 上的 IoTDB 实例</li><li>输入 SQL 指令 <code>load 'http://168.121.0.2:8000/root/data/1-1-0-0.tsfile'</code></li><li>等待加载完成</li></ol><p><strong>请注意</strong>：采用远程加载的情况下，仅支持加载单个文件，即路径参数必须为单个 TsFile 文件路径。同时如果您的 TsFile 经历过删除操作（即，TsFile 文件有附带的 .mods 文件），也不推荐您使用远程加载，这将导致本该被删除的数据在加载之后仍然没有被删除。</p><h3 id="删除-tsfile-文件" tabindex="-1"><a class="header-anchor" href="#删除-tsfile-文件"><span>删除 tsfile 文件</span></a></h3><p>删除 tsfile 文件的指令为：<code>remove '<path>'</code></p><p>该指令通过指定文件路径删除 tsfile 文件，具体做法是将该 tsfile 和其对应的<code>.resource</code>和<code>.modification</code>文件全部删除。</p><p>示例：</p><ul><li><code>remove '/Users/Desktop/data/data/root.vehicle/0/0/1575028885956-101-0.tsfile'</code></li></ul><h3 id="卸载-tsfile-文件至指定目录" tabindex="-1"><a class="header-anchor" href="#卸载-tsfile-文件至指定目录"><span>卸载 tsfile 文件至指定目录</span></a></h3><p>卸载 tsfile 文件的指令为：<code>unload '<path>' '<dir>'</code></p><p>该指令将指定路径的 tsfile 文件卸载并移动至目标文件夹（绝对路径）中，具体做法是在引擎中卸载该 tsfile，并将该 tsfile 文件和其对应的<code>.resource</code>文件移动到目标文件夹下</p><p>示例：</p><ul><li><code>unload '/Users/Desktop/data/data/root.vehicle/0/0/1575028885956-101-0.tsfile' '/data/data/tmp'</code></li></ul>',23);function u(m,g){const s=a("ExternalLinkIcon");return i(),r("div",null,[p,t("p",null,[e("SGLEVEL 选项，当 tsfile 对应的存储组不存在时，用户可以通过 sglevel 参数的值来制定存储组的级别，默认为"),n,e("中设置的级别。例如当设置 level 参数为1时表明此 tsfile 中所有时间序列中层级为1的前缀路径是存储组，即若存在设备 root.sg.d1.s1，此时 "),t("a",f,[e("root.sg"),d(s)]),e(" 被指定为存储组。")]),h])}const D=o(c,[["render",u],["__file","Load-External-Tsfile.html.vue"]]),_=JSON.parse(`{"path":"/zh/UserGuide/V0.13.x/Write-And-Delete-Data/Load-External-Tsfile.html","title":"","lang":"zh-CN","frontmatter":{"description":"加载 TsFile 介绍 加载外部 tsfile 文件工具允许用户向正在运行中的 Apache IoTDB 中加载、删除或移出 tsfile 文件。 使用方式 用户通过 Cli 工具或 JDBC 向 Apache IoTDB 系统发送指定命令实现文件加载的功能。 加载 tsfile 文件 加载 tsfile 文件的指令为：load '<path/dir...","head":[["link",{"rel":"alternate","hreflang":"en-us","href":"https://iotdb.apache.org/UserGuide/V0.13.x/Write-And-Delete-Data/Load-External-Tsfile.html"}],["meta",{"property":"og:url","content":"https://iotdb.apache.org/zh/UserGuide/V0.13.x/Write-And-Delete-Data/Load-External-Tsfile.html"}],["meta",{"property":"og:site_name","content":"IoTDB Website"}],["meta",{"property":"og:description","content":"加载 TsFile 介绍 加载外部 tsfile 文件工具允许用户向正在运行中的 Apache IoTDB 中加载、删除或移出 tsfile 文件。 使用方式 用户通过 Cli 工具或 JDBC 向 Apache IoTDB 系统发送指定命令实现文件加载的功能。 加载 tsfile 文件 加载 tsfile 文件的指令为：load '<path/dir..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"zh-CN"}],["meta",{"property":"og:locale:alternate","content":"en-US"}],["meta",{"property":"og:updated_time","content":"2023-07-10T03:11:17.000Z"}],["meta",{"property":"article:modified_time","content":"2023-07-10T03:11:17.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2023-07-10T03:11:17.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":2,"title":"加载 TsFile","slug":"加载-tsfile","link":"#加载-tsfile","children":[{"level":3,"title":"介绍","slug":"介绍","link":"#介绍","children":[]},{"level":3,"title":"使用方式","slug":"使用方式","link":"#使用方式","children":[]},{"level":3,"title":"删除 tsfile 文件","slug":"删除-tsfile-文件","link":"#删除-tsfile-文件","children":[]},{"level":3,"title":"卸载 tsfile 文件至指定目录","slug":"卸载-tsfile-文件至指定目录","link":"#卸载-tsfile-文件至指定目录","children":[]}]}],"git":{"createdTime":1688958677000,"updatedTime":1688958677000,"contributors":[{"name":"CritasWang","email":"critas@outlook.com","commits":1}]},"readingTime":{"minutes":4.3,"words":1291},"filePathRelative":"zh/UserGuide/V0.13.x/Write-And-Delete-Data/Load-External-Tsfile.md","localizedDate":"2023年7月10日","autoDesc":true}`);export{D as comp,_ as data}; |