You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iotdb.apache.org by lt...@apache.org on 2019/12/26 03:50:50 UTC
[incubator-iotdb] branch rel/0.9-load updated: update doc
This is an automated email from the ASF dual-hosted git repository.
lta pushed a commit to branch rel/0.9-load
in repository https://gitbox.apache.org/repos/asf/incubator-iotdb.git
The following commit(s) were added to refs/heads/rel/0.9-load by this push:
new 6f26451 update doc
6f26451 is described below
commit 6f26451dd1c976797ff83c2aac120f75fbf80b57
Author: lta <li...@163.com>
AuthorDate: Thu Dec 26 11:50:31 2019 +0800
update doc
---
.../6-System Tools/8-Load External Tsfile.md | 21 +++++++++++++++++----
.../6-System Tools/8-Load External Tsfile.md | 22 ++++++++++++++++++----
2 files changed, 35 insertions(+), 8 deletions(-)
diff --git a/docs/Documentation-CHN/UserGuide/6-System Tools/8-Load External Tsfile.md b/docs/Documentation-CHN/UserGuide/6-System Tools/8-Load External Tsfile.md
index 57d58f0..4af05a8 100644
--- a/docs/Documentation-CHN/UserGuide/6-System Tools/8-Load External Tsfile.md
+++ b/docs/Documentation-CHN/UserGuide/6-System Tools/8-Load External Tsfile.md
@@ -38,9 +38,22 @@
# 使用方式
用户通过Cli工具或JDBC向Apache IoTDB系统发送指定命令实现文件加载的功能。
## 加载tsfile文件
-加载tsfile文件的指令为：`load <path/dir>`
+加载tsfile文件的指令为：`load <path/dir> [true/false] [storage group level]`
该指令有两种用法：
-1. 通过指定文件路径(绝对路径)加载单tsfile文件，该文件名称需要符合tsfile的命名规范，即`{systemTime}-{versionNum}-{mergeNum}.tsfile`。若该文件对应的`.resource`文件存在，会被一并加载至Apache IoTDB数据文件的目录和引擎中，否则将通过tsfile文件重新生成对应的`.resource`文件，即加载的tsfile文件所对应的`.resource`文件不是必要的。
-
-2. 通过指定文件夹路径(绝对路径)批量加载文件，待加载的tsfile文件名称需要符合tsfile的命名规范，即`{systemTime}-{versionNum}-{mergeNum}.tsfile`。若待加载文件对应的`.resource`文件存在，则会一并加载至Apache IoTDB数据文件目录和引擎中，否则将通过tsfile文件重新生成对应的`.resource`文件，即加载的tsfile文件所对应的`.resource`文件不是必要的。
\ No newline at end of file
+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 2`
+
+
+2. 通过指定文件夹路径(绝对路径)批量加载文件。
+第二个参数表示待加载的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 2`
\ No newline at end of file
diff --git a/docs/Documentation/UserGuide/6-System Tools/8-Load External Tsfile.md b/docs/Documentation/UserGuide/6-System Tools/8-Load External Tsfile.md
index 24eb561..07df988 100644
--- a/docs/Documentation/UserGuide/6-System Tools/8-Load External Tsfile.md
+++ b/docs/Documentation/UserGuide/6-System Tools/8-Load External Tsfile.md
@@ -29,9 +29,23 @@ The load external tsfile tool allows users to load tsfiles, delete a tsfile, or
The user sends specified commands to the Apache IoTDB system through the Cli tool or JDBC to use the tool.
## load tsfiles
-The command to load tsfiles is `load <path/dir>`.
+The command to load tsfiles is `load <path/dir> [true/false] [storage group level]`.
This command has two usages:
-1. Load a single tsfile by specifying a file path (absolute path). The name of the tsfile needs to conform to the tsfile naming convention, that is, `{systemTime}-{versionNum}-{mergeNum} .tsfile`. If the `.resource` file corresponding to the file exists, it will be loaded into the data directory and engine of the Apache IoTDB. Otherwise, the corresponding `.resource` file will be regenerated from the tsfile file.
-
-2. Load a batch of files by specifying a folder path (absolute path). The name of the tsfiles need to conform to the tsfile naming convention, that is, `{systemTime}-{versionNum}-{mergeNum} .tsfile`. If the `.resource` file corresponding to the file exists, they will be loaded into the data directory and engine of the Apache IoTDB. Otherwise, the corresponding` .resource` files will be regenerated from the tsfile sfile.
\ No newline at end of file
+1. Load a single tsfile by specifying a file path (absolute path).
+The second parameter indicates the path of the tsfile to be loaded and the name of the tsfile needs to conform to the tsfile naming convention, that is, `{systemTime}-{versionNum}-{mergeNum} .tsfile`. The third and fourth parameters are optional. When the metadata corresponding to the timeseries in the tsfile to be loaded does not exist, you can choose whether to create the schema automatically. If the third parameter is true, the schema will be created automatically. If the thrid parame [...]
+If the `.resource` file corresponding to the file exists, it will be loaded into the data directory and engine of the Apache IoTDB. Otherwise, the corresponding `.resource` file will be regenerated from the tsfile file.
+Examples:
+ * `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 2`
+
+2. Load a batch of files by specifying a folder path (absolute path).
+The second parameter indicates the path of the tsfile to be loaded and the name of the tsfiles need to conform to the tsfile naming convention, that is, `{systemTime}-{versionNum}-{mergeNum} .tsfile`. The third and fourth parameters are optional. When the metadata corresponding to the time series in the tsfile to be loaded does not exist, you can choose whether to create the schema automatically. If the third parameter is true, the schema will be created automatically. If the third param [...]
+If the `.resource` file corresponding to the file exists, they will be loaded into the data directory and engine of the Apache IoTDB. Otherwise, the corresponding` .resource` files will be regenerated from the tsfile sfile.
+Examples:
+ * `load /Users/Desktop/data`
+ * `load /Users/Desktop/data false`
+ * `load /Users/Desktop/data true`
+ * `load /Users/Desktop/data true 2`