This is an automated email from the ASF dual-hosted git repository.
HTHou pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iotdb-docs.git
The following commit(s) were added to refs/heads/main by this push:
new a839dbc6 The parameter of model becomes invalid starting from
V2.0.2.1. The system automatically identifies whether the data model is
tree-based or table-based. (#1102)
a839dbc6 is described below
commit a839dbc6166b8d560b640d732ba2fb22380a89be
Author: leto-b <[email protected]>
AuthorDate: Thu Apr 30 10:13:06 2026 +0800
The parameter of model becomes invalid starting from V2.0.2.1. The system
automatically identifies whether the data model is tree-based or table-based.
(#1102)
---
src/UserGuide/Master/Table/Tools-System/Data-Import-Tool_timecho.md | 2 +-
src/UserGuide/Master/Tree/Tools-System/Data-Import-Tool_timecho.md | 2 +-
src/UserGuide/latest-Table/Tools-System/Data-Import-Tool_timecho.md | 2 +-
src/UserGuide/latest/Tools-System/Data-Import-Tool_timecho.md | 2 +-
src/zh/UserGuide/Master/Table/Tools-System/Data-Import-Tool_timecho.md | 2 +-
src/zh/UserGuide/Master/Tree/Tools-System/Data-Import-Tool_timecho.md | 2 +-
src/zh/UserGuide/latest-Table/Tools-System/Data-Import-Tool_timecho.md | 2 +-
src/zh/UserGuide/latest/Tools-System/Data-Import-Tool_timecho.md | 2 +-
8 files changed, 8 insertions(+), 8 deletions(-)
diff --git
a/src/UserGuide/Master/Table/Tools-System/Data-Import-Tool_timecho.md
b/src/UserGuide/Master/Table/Tools-System/Data-Import-Tool_timecho.md
index 13ca4ff7..7c18a1e5 100644
--- a/src/UserGuide/Master/Table/Tools-System/Data-Import-Tool_timecho.md
+++ b/src/UserGuide/Master/Table/Tools-System/Data-Import-Tool_timecho.md
@@ -281,7 +281,7 @@ load '<path/dir>' with (
|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------|--------------------------------|-------------------|----------------------------|
| `database-level` | When the database corresponding to the
TsFile does not exist, the database hierarchy level can be specified via the `
database-level` parameter. The default is the level set in
`iotdb-common.properties`. For example, setting level=1 means the prefix path
of level 1 in all time series in the TsFile will be used as the database. |
Integer | `[1: Integer.MAX_VALUE]` | No | 1
|
| `on-success` | Action for successfully loaded TsFiles:
`delete` (delete the TsFile after successful import) or `none` (retain the
TsFile in the source folder).
| String | `delete /
none` | No | delete |
-| `model` | Specifies whether the TsFile uses the
`table` model or `tree` model.
| String | `tree /
table` | No | Aligns with `-sql_dialect` |
+| `model` | Specifies whether the TsFile uses the
`table` model or `tree` model. This parameter becomes invalid starting from
V2.0.2.1. The system automatically identifies whether the data model is
tree-based or table-based.
[...]
| `database-name` | Table model only: Target database for
import. Automatically created if it does not exist. The database-name must not
include the `root.` prefix (an error will occur if included).
| String | `-`
| No | null |
| `convert-on-type-mismatch` | Whether to perform type conversion during
loading if data types in the TsFile mismatch the target schema.
| Boolean | `true / false`
| No | true |
| `verify` | Whether to validate the schema before
loading the TsFile.
| Boolean | `true /
false` | No | true |
diff --git a/src/UserGuide/Master/Tree/Tools-System/Data-Import-Tool_timecho.md
b/src/UserGuide/Master/Tree/Tools-System/Data-Import-Tool_timecho.md
index bb5dbfcd..9296b814 100644
--- a/src/UserGuide/Master/Tree/Tools-System/Data-Import-Tool_timecho.md
+++ b/src/UserGuide/Master/Tree/Tools-System/Data-Import-Tool_timecho.md
@@ -296,7 +296,7 @@ load '<path/dir>' with (
|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------|--------------------------------|-------------------|----------------------------|
| `database-level` | When the database corresponding to the
TsFile does not exist, the database hierarchy level can be specified via the `
database-level` parameter. The default is the level set in
`iotdb-common.properties`. For example, setting level=1 means the prefix path
of level 1 in all time series in the TsFile will be used as the database. |
Integer | `[1: Integer.MAX_VALUE]` | No | 1
|
| `on-success` | Action for successfully loaded TsFiles:
`delete` (delete the TsFile after successful import) or `none` (retain the
TsFile in the source folder).
| String | `delete /
none` | No | delete |
-| `model` | Specifies whether the TsFile uses the
`table` model or `tree` model.
| String | `tree /
table` | No | Aligns with `-sql_dialect` |
+| `model` | Specifies whether the TsFile uses the
`table` model or `tree` model. This parameter becomes invalid starting from
V2.0.2.1. The system automatically identifies whether the data model is
tree-based or table-based.
[...]
| `database-name` | Table model only: Target database for
import. Automatically created if it does not exist. The database-name must not
include the `root.` prefix (an error will occur if included).
| String | `-`
| No | null |
| `convert-on-type-mismatch` | Whether to perform type conversion during
loading if data types in the TsFile mismatch the target schema.
| Boolean | `true / false`
| No | true |
| `verify` | Whether to validate the schema before
loading the TsFile.
| Boolean | `true /
false` | No | true |
diff --git
a/src/UserGuide/latest-Table/Tools-System/Data-Import-Tool_timecho.md
b/src/UserGuide/latest-Table/Tools-System/Data-Import-Tool_timecho.md
index 13ca4ff7..6f826310 100644
--- a/src/UserGuide/latest-Table/Tools-System/Data-Import-Tool_timecho.md
+++ b/src/UserGuide/latest-Table/Tools-System/Data-Import-Tool_timecho.md
@@ -281,7 +281,7 @@ load '<path/dir>' with (
|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------|--------------------------------|-------------------|----------------------------|
| `database-level` | When the database corresponding to the
TsFile does not exist, the database hierarchy level can be specified via the `
database-level` parameter. The default is the level set in
`iotdb-common.properties`. For example, setting level=1 means the prefix path
of level 1 in all time series in the TsFile will be used as the database. |
Integer | `[1: Integer.MAX_VALUE]` | No | 1
|
| `on-success` | Action for successfully loaded TsFiles:
`delete` (delete the TsFile after successful import) or `none` (retain the
TsFile in the source folder).
| String | `delete /
none` | No | delete |
-| `model` | Specifies whether the TsFile uses the
`table` model or `tree` model.
| String | `tree /
table` | No | Aligns with `-sql_dialect` |
+| `model` | Specifies whether the TsFile uses the
`table` model or `tree` model. This parameter becomes invalid starting from
V2.0.2.1. The system automatically identifies whether the data model is
tree-based or table-based.
[...]
| `database-name` | Table model only: Target database for
import. Automatically created if it does not exist. The database-name must not
include the `root.` prefix (an error will occur if included).
| String | `-`
| No | null |
| `convert-on-type-mismatch` | Whether to perform type conversion during
loading if data types in the TsFile mismatch the target schema.
| Boolean | `true / false`
| No | true |
| `verify` | Whether to validate the schema before
loading the TsFile.
| Boolean | `true /
false` | No | true |
diff --git a/src/UserGuide/latest/Tools-System/Data-Import-Tool_timecho.md
b/src/UserGuide/latest/Tools-System/Data-Import-Tool_timecho.md
index bb5dbfcd..32bd2a12 100644
--- a/src/UserGuide/latest/Tools-System/Data-Import-Tool_timecho.md
+++ b/src/UserGuide/latest/Tools-System/Data-Import-Tool_timecho.md
@@ -296,7 +296,7 @@ load '<path/dir>' with (
|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------|--------------------------------|-------------------|----------------------------|
| `database-level` | When the database corresponding to the
TsFile does not exist, the database hierarchy level can be specified via the `
database-level` parameter. The default is the level set in
`iotdb-common.properties`. For example, setting level=1 means the prefix path
of level 1 in all time series in the TsFile will be used as the database. |
Integer | `[1: Integer.MAX_VALUE]` | No | 1
|
| `on-success` | Action for successfully loaded TsFiles:
`delete` (delete the TsFile after successful import) or `none` (retain the
TsFile in the source folder).
| String | `delete /
none` | No | delete |
-| `model` | Specifies whether the TsFile uses the
`table` model or `tree` model.
| String | `tree /
table` | No | Aligns with `-sql_dialect` |
+| `model` | Specifies whether the TsFile uses the
`table` model or `tree` model. This parameter becomes invalid starting from
V2.0.2.1. The system automatically identifies whether the data model is
tree-based or table-based.
[...]
| `database-name` | Table model only: Target database for
import. Automatically created if it does not exist. The database-name must not
include the `root.` prefix (an error will occur if included).
| String | `-`
| No | null |
| `convert-on-type-mismatch` | Whether to perform type conversion during
loading if data types in the TsFile mismatch the target schema.
| Boolean | `true / false`
| No | true |
| `verify` | Whether to validate the schema before
loading the TsFile.
| Boolean | `true /
false` | No | true |
diff --git
a/src/zh/UserGuide/Master/Table/Tools-System/Data-Import-Tool_timecho.md
b/src/zh/UserGuide/Master/Table/Tools-System/Data-Import-Tool_timecho.md
index 153debd5..6341f064 100644
--- a/src/zh/UserGuide/Master/Table/Tools-System/Data-Import-Tool_timecho.md
+++ b/src/zh/UserGuide/Master/Table/Tools-System/Data-Import-Tool_timecho.md
@@ -286,7 +286,7 @@ load '<path/dir>' with (
| ---------------------------------------
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
------------ | ----------------------------------------- | ---------------- |
-------------------------- |
| `database-level` | 当 tsfile 对应的 database 不存在时，可以通过`
database-level`参数的值来制定 database
的级别，默认为`iotdb-common.properties`中设置的级别。<br>例如当设置 level 参数为 1 时表明此 tsfile
中所有时间序列中层级为1的前缀路径是 database。 | Integer | `[1: Integer.MAX_VALUE]`
| 否 | 1 |
| `on-success` | 表示对于成功载入的 tsfile
的处置方式:默认为`delete`，即tsfile 成功加载后将被删除;`none `表明 tsfile 成功加载之后依然被保留在源文件夹,
| String
| `delete / none` | 否 | delete
|
-| `model` | 指定写入的 tsfile 是表模型还是树模型
| String | `tree / table`
| 否 | 与`-sql_dialect`一致 |
+| `model` | 指定写入的 tsfile
是表模型还是树模型，该参数在V2.0.2.1后无效(系统会自动识别是树模型还是表模型)
| String | `tree / table`
| 否 | 与`-sql_dialect`一致 |
| `database-name` | **仅限表模型有效**: 文件导入的目标
database，不存在时会自动创建，`database-name`中不允许包括"`root.`"前缀，如果包含，将会报错。
| String
| `-` | 否 | null
|
| `convert-on-type-mismatch` | 加载 tsfile 时，如果数据类型不一致，是否进行转换
| Boolean | `true / false`
| 否 | true |
| `verify` | 加载 tsfile 前是否校验 schema
| Boolean | `true / false`
| 否 | true |
diff --git
a/src/zh/UserGuide/Master/Tree/Tools-System/Data-Import-Tool_timecho.md
b/src/zh/UserGuide/Master/Tree/Tools-System/Data-Import-Tool_timecho.md
index 949cddd4..f0c05341 100644
--- a/src/zh/UserGuide/Master/Tree/Tools-System/Data-Import-Tool_timecho.md
+++ b/src/zh/UserGuide/Master/Tree/Tools-System/Data-Import-Tool_timecho.md
@@ -301,7 +301,7 @@ load '<path/dir>' with (
| ---------------------------------------
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
------------ | ----------------------------------------- | ---------------- |
-------------------------- |
| `database-level` | 当 tsfile 对应的 database 不存在时，可以通过`
database-level`参数的值来制定 database
的级别，默认为`iotdb-common.properties`中设置的级别。<br>例如当设置 level 参数为 1 时表明此 tsfile
中所有时间序列中层级为1的前缀路径是 database。 | Integer | `[1: Integer.MAX_VALUE]`
| 否 | 1 |
| `on-success` | 表示对于成功载入的 tsfile
的处置方式:默认为`delete`，即tsfile 成功加载后将被删除;`none `表明 tsfile 成功加载之后依然被保留在源文件夹,
| String
| `delete / none` | 否 | delete
|
-| `model` | 指定写入的 tsfile 是表模型还是树模型
| String | `tree / table`
| 否 | 与`-sql_dialect`一致 |
+| `model` | 指定写入的 tsfile
是表模型还是树模型，该参数在V2.0.2.1后无效(系统会自动识别是树模型还是表模型)
| String | `tree / table`
| 否 | 与`-sql_dialect`一致 |
| `database-name` | **仅限表模型有效**: 文件导入的目标
database，不存在时会自动创建，`database-name`中不允许包括"`root.`"前缀，如果包含，将会报错。
| String
| `-` | 否 | null
|
| `convert-on-type-mismatch` | 加载 tsfile 时，如果数据类型不一致，是否进行转换
| Boolean | `true / false`
| 否 | true |
| `verify` | 加载 tsfile 前是否校验 schema
| Boolean | `true / false`
| 否 | true |
diff --git
a/src/zh/UserGuide/latest-Table/Tools-System/Data-Import-Tool_timecho.md
b/src/zh/UserGuide/latest-Table/Tools-System/Data-Import-Tool_timecho.md
index 153debd5..6341f064 100644
--- a/src/zh/UserGuide/latest-Table/Tools-System/Data-Import-Tool_timecho.md
+++ b/src/zh/UserGuide/latest-Table/Tools-System/Data-Import-Tool_timecho.md
@@ -286,7 +286,7 @@ load '<path/dir>' with (
| ---------------------------------------
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
------------ | ----------------------------------------- | ---------------- |
-------------------------- |
| `database-level` | 当 tsfile 对应的 database 不存在时，可以通过`
database-level`参数的值来制定 database
的级别，默认为`iotdb-common.properties`中设置的级别。<br>例如当设置 level 参数为 1 时表明此 tsfile
中所有时间序列中层级为1的前缀路径是 database。 | Integer | `[1: Integer.MAX_VALUE]`
| 否 | 1 |
| `on-success` | 表示对于成功载入的 tsfile
的处置方式:默认为`delete`，即tsfile 成功加载后将被删除;`none `表明 tsfile 成功加载之后依然被保留在源文件夹,
| String
| `delete / none` | 否 | delete
|
-| `model` | 指定写入的 tsfile 是表模型还是树模型
| String | `tree / table`
| 否 | 与`-sql_dialect`一致 |
+| `model` | 指定写入的 tsfile
是表模型还是树模型，该参数在V2.0.2.1后无效(系统会自动识别是树模型还是表模型)
| String | `tree / table`
| 否 | 与`-sql_dialect`一致 |
| `database-name` | **仅限表模型有效**: 文件导入的目标
database，不存在时会自动创建，`database-name`中不允许包括"`root.`"前缀，如果包含，将会报错。
| String
| `-` | 否 | null
|
| `convert-on-type-mismatch` | 加载 tsfile 时，如果数据类型不一致，是否进行转换
| Boolean | `true / false`
| 否 | true |
| `verify` | 加载 tsfile 前是否校验 schema
| Boolean | `true / false`
| 否 | true |
diff --git a/src/zh/UserGuide/latest/Tools-System/Data-Import-Tool_timecho.md
b/src/zh/UserGuide/latest/Tools-System/Data-Import-Tool_timecho.md
index 949cddd4..aed95c56 100644
--- a/src/zh/UserGuide/latest/Tools-System/Data-Import-Tool_timecho.md
+++ b/src/zh/UserGuide/latest/Tools-System/Data-Import-Tool_timecho.md
@@ -301,7 +301,7 @@ load '<path/dir>' with (
| ---------------------------------------
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
------------ | ----------------------------------------- | ---------------- |
-------------------------- |
| `database-level` | 当 tsfile 对应的 database 不存在时，可以通过`
database-level`参数的值来制定 database
的级别，默认为`iotdb-common.properties`中设置的级别。<br>例如当设置 level 参数为 1 时表明此 tsfile
中所有时间序列中层级为1的前缀路径是 database。 | Integer | `[1: Integer.MAX_VALUE]`
| 否 | 1 |
| `on-success` | 表示对于成功载入的 tsfile
的处置方式:默认为`delete`，即tsfile 成功加载后将被删除;`none `表明 tsfile 成功加载之后依然被保留在源文件夹,
| String
| `delete / none` | 否 | delete
|
-| `model` | 指定写入的 tsfile 是表模型还是树模型
| String | `tree / table`
| 否 | 与`-sql_dialect`一致 |
+| `model` | 指定写入的 tsfile
是表模型还是树模型，该参数在V2.0.2.1后无效(系统会自动识别是树模型还是表模型)
|
String | `tree / table` | 否 |
与`-sql_dialect`一致 |
| `database-name` | **仅限表模型有效**: 文件导入的目标
database，不存在时会自动创建，`database-name`中不允许包括"`root.`"前缀，如果包含，将会报错。
| String
| `-` | 否 | null
|
| `convert-on-type-mismatch` | 加载 tsfile 时，如果数据类型不一致，是否进行转换
| Boolean | `true / false`
| 否 | true |
| `verify` | 加载 tsfile 前是否校验 schema
| Boolean | `true / false`
| 否 | true |
