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 58be67d8 add description about time and timestamp when inserting data
in tree mode (#1122)
58be67d8 is described below
commit 58be67d866b657d002a0607d52aa384a9656048f
Author: leto-b <[email protected]>
AuthorDate: Fri May 22 09:49:26 2026 +0800
add description about time and timestamp when inserting data in tree mode
(#1122)
---
src/UserGuide/Master/Tree/Basic-Concept/Write-Data_apache.md | 2 ++
src/UserGuide/Master/Tree/Basic-Concept/Write-Data_timecho.md | 2 ++
src/UserGuide/V1.3.x/Basic-Concept/Write-Data.md | 2 ++
src/UserGuide/dev-1.3/Basic-Concept/Write-Data.md | 2 ++
src/UserGuide/latest/Basic-Concept/Write-Data_apache.md | 2 ++
src/UserGuide/latest/Basic-Concept/Write-Data_timecho.md | 2 ++
src/zh/UserGuide/Master/Tree/Basic-Concept/Write-Data_apache.md | 2 ++
src/zh/UserGuide/Master/Tree/Basic-Concept/Write-Data_timecho.md | 2 ++
src/zh/UserGuide/V1.3.x/Basic-Concept/Write-Data.md | 2 ++
src/zh/UserGuide/dev-1.3/Basic-Concept/Write-Data.md | 2 ++
src/zh/UserGuide/latest/Basic-Concept/Write-Data_apache.md | 2 ++
src/zh/UserGuide/latest/Basic-Concept/Write-Data_timecho.md | 2 ++
12 files changed, 24 insertions(+)
diff --git a/src/UserGuide/Master/Tree/Basic-Concept/Write-Data_apache.md
b/src/UserGuide/Master/Tree/Basic-Concept/Write-Data_apache.md
index 53d9b6d6..3a43ad96 100644
--- a/src/UserGuide/Master/Tree/Basic-Concept/Write-Data_apache.md
+++ b/src/UserGuide/Master/Tree/Basic-Concept/Write-Data_apache.md
@@ -58,6 +58,8 @@ In addition, The INSERT statement support insert multi-rows
at once. The sample
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+When writing data to the tree model, both timestamp and time can be used as
time column identifiers in INSERT statements, and there is no need to
deliberately distinguish between them when writing statements. However, in
query results, the time column is uniformly displayed as Time (a fixed name) to
ensure a consistent result format.
+
After inserting the data, we can simply query the inserted data using the
SELECT statement:
```sql
diff --git a/src/UserGuide/Master/Tree/Basic-Concept/Write-Data_timecho.md
b/src/UserGuide/Master/Tree/Basic-Concept/Write-Data_timecho.md
index 56482040..33ba179f 100644
--- a/src/UserGuide/Master/Tree/Basic-Concept/Write-Data_timecho.md
+++ b/src/UserGuide/Master/Tree/Basic-Concept/Write-Data_timecho.md
@@ -58,6 +58,8 @@ In addition, The INSERT statement support insert multi-rows
at once. The sample
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+When writing data to the tree model, both timestamp and time can be used as
time column identifiers in INSERT statements, and there is no need to
deliberately distinguish between them when writing statements. However, in
query results, the time column is uniformly displayed as Time (a fixed name) to
ensure a consistent result format.
+
After inserting the data, we can simply query the inserted data using the
SELECT statement:
```sql
diff --git a/src/UserGuide/V1.3.x/Basic-Concept/Write-Data.md
b/src/UserGuide/V1.3.x/Basic-Concept/Write-Data.md
index f6f3e12d..a5fdd7da 100644
--- a/src/UserGuide/V1.3.x/Basic-Concept/Write-Data.md
+++ b/src/UserGuide/V1.3.x/Basic-Concept/Write-Data.md
@@ -58,6 +58,8 @@ In addition, The INSERT statement support insert multi-rows
at once. The sample
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+When writing data to the tree model, both timestamp and time can be used as
time column identifiers in INSERT statements, and there is no need to
deliberately distinguish between them when writing statements. However, in
query results, the time column is uniformly displayed as Time (a fixed name) to
ensure a consistent result format.
+
After inserting the data, we can simply query the inserted data using the
SELECT statement:
```sql
diff --git a/src/UserGuide/dev-1.3/Basic-Concept/Write-Data.md
b/src/UserGuide/dev-1.3/Basic-Concept/Write-Data.md
index f6f3e12d..a5fdd7da 100644
--- a/src/UserGuide/dev-1.3/Basic-Concept/Write-Data.md
+++ b/src/UserGuide/dev-1.3/Basic-Concept/Write-Data.md
@@ -58,6 +58,8 @@ In addition, The INSERT statement support insert multi-rows
at once. The sample
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+When writing data to the tree model, both timestamp and time can be used as
time column identifiers in INSERT statements, and there is no need to
deliberately distinguish between them when writing statements. However, in
query results, the time column is uniformly displayed as Time (a fixed name) to
ensure a consistent result format.
+
After inserting the data, we can simply query the inserted data using the
SELECT statement:
```sql
diff --git a/src/UserGuide/latest/Basic-Concept/Write-Data_apache.md
b/src/UserGuide/latest/Basic-Concept/Write-Data_apache.md
index 5085b033..7f16b6ef 100644
--- a/src/UserGuide/latest/Basic-Concept/Write-Data_apache.md
+++ b/src/UserGuide/latest/Basic-Concept/Write-Data_apache.md
@@ -58,6 +58,8 @@ In addition, The INSERT statement support insert multi-rows
at once. The sample
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+When writing data to the tree model, both timestamp and time can be used as
time column identifiers in INSERT statements, and there is no need to
deliberately distinguish between them when writing statements. However, in
query results, the time column is uniformly displayed as Time (a fixed name) to
ensure a consistent result format.
+
After inserting the data, we can simply query the inserted data using the
SELECT statement:
```sql
diff --git a/src/UserGuide/latest/Basic-Concept/Write-Data_timecho.md
b/src/UserGuide/latest/Basic-Concept/Write-Data_timecho.md
index 7831c716..54927276 100644
--- a/src/UserGuide/latest/Basic-Concept/Write-Data_timecho.md
+++ b/src/UserGuide/latest/Basic-Concept/Write-Data_timecho.md
@@ -58,6 +58,8 @@ In addition, The INSERT statement support insert multi-rows
at once. The sample
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+When writing data to the tree model, both timestamp and time can be used as
time column identifiers in INSERT statements, and there is no need to
deliberately distinguish between them when writing statements. However, in
query results, the time column is uniformly displayed as Time (a fixed name) to
ensure a consistent result format.
+
After inserting the data, we can simply query the inserted data using the
SELECT statement:
```sql
diff --git a/src/zh/UserGuide/Master/Tree/Basic-Concept/Write-Data_apache.md
b/src/zh/UserGuide/Master/Tree/Basic-Concept/Write-Data_apache.md
index 2a1254bd..fc2ffd02 100644
--- a/src/zh/UserGuide/Master/Tree/Basic-Concept/Write-Data_apache.md
+++ b/src/zh/UserGuide/Master/Tree/Basic-Concept/Write-Data_apache.md
@@ -58,6 +58,8 @@ IoTDB > insert into root.ln.wf02.wt02(timestamp, status,
hardware) values (2, fa
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+在树模型写入数据时，timestamp 与 time 均可作为时间列标识用于 INSERT 语句，书写时无需刻意区分；但查询结果中，时间列统一展示为
Time（固定名称），保证结果格式统一。
+
插入数据后我们可以使用 SELECT 语句简单查询已插入的数据。
```sql
diff --git a/src/zh/UserGuide/Master/Tree/Basic-Concept/Write-Data_timecho.md
b/src/zh/UserGuide/Master/Tree/Basic-Concept/Write-Data_timecho.md
index 03e8aab2..4bdd250e 100644
--- a/src/zh/UserGuide/Master/Tree/Basic-Concept/Write-Data_timecho.md
+++ b/src/zh/UserGuide/Master/Tree/Basic-Concept/Write-Data_timecho.md
@@ -58,6 +58,8 @@ IoTDB > insert into root.ln.wf02.wt02(timestamp, status,
hardware) values (2, fa
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+在树模型写入数据时，timestamp 与 time 均可作为时间列标识用于 INSERT 语句，书写时无需刻意区分；但查询结果中，时间列统一展示为
Time（固定名称），保证结果格式统一。
+
插入数据后我们可以使用 SELECT 语句简单查询已插入的数据。
```sql
diff --git a/src/zh/UserGuide/V1.3.x/Basic-Concept/Write-Data.md
b/src/zh/UserGuide/V1.3.x/Basic-Concept/Write-Data.md
index 46f0c755..6ca9dd21 100644
--- a/src/zh/UserGuide/V1.3.x/Basic-Concept/Write-Data.md
+++ b/src/zh/UserGuide/V1.3.x/Basic-Concept/Write-Data.md
@@ -58,6 +58,8 @@ IoTDB > insert into root.ln.wf02.wt02(timestamp, status,
hardware) values (2, fa
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+在树模型写入数据时，timestamp 与 time 均可作为时间列标识用于 INSERT 语句，书写时无需刻意区分；但查询结果中，时间列统一展示为
Time（固定名称），保证结果格式统一。
+
插入数据后我们可以使用 SELECT 语句简单查询已插入的数据。
```sql
diff --git a/src/zh/UserGuide/dev-1.3/Basic-Concept/Write-Data.md
b/src/zh/UserGuide/dev-1.3/Basic-Concept/Write-Data.md
index 46f0c755..6ca9dd21 100644
--- a/src/zh/UserGuide/dev-1.3/Basic-Concept/Write-Data.md
+++ b/src/zh/UserGuide/dev-1.3/Basic-Concept/Write-Data.md
@@ -58,6 +58,8 @@ IoTDB > insert into root.ln.wf02.wt02(timestamp, status,
hardware) values (2, fa
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+在树模型写入数据时，timestamp 与 time 均可作为时间列标识用于 INSERT 语句，书写时无需刻意区分；但查询结果中，时间列统一展示为
Time（固定名称），保证结果格式统一。
+
插入数据后我们可以使用 SELECT 语句简单查询已插入的数据。
```sql
diff --git a/src/zh/UserGuide/latest/Basic-Concept/Write-Data_apache.md
b/src/zh/UserGuide/latest/Basic-Concept/Write-Data_apache.md
index 2a1254bd..fc2ffd02 100644
--- a/src/zh/UserGuide/latest/Basic-Concept/Write-Data_apache.md
+++ b/src/zh/UserGuide/latest/Basic-Concept/Write-Data_apache.md
@@ -58,6 +58,8 @@ IoTDB > insert into root.ln.wf02.wt02(timestamp, status,
hardware) values (2, fa
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+在树模型写入数据时，timestamp 与 time 均可作为时间列标识用于 INSERT 语句，书写时无需刻意区分；但查询结果中，时间列统一展示为
Time（固定名称），保证结果格式统一。
+
插入数据后我们可以使用 SELECT 语句简单查询已插入的数据。
```sql
diff --git a/src/zh/UserGuide/latest/Basic-Concept/Write-Data_timecho.md
b/src/zh/UserGuide/latest/Basic-Concept/Write-Data_timecho.md
index 03e8aab2..4bdd250e 100644
--- a/src/zh/UserGuide/latest/Basic-Concept/Write-Data_timecho.md
+++ b/src/zh/UserGuide/latest/Basic-Concept/Write-Data_timecho.md
@@ -58,6 +58,8 @@ IoTDB > insert into root.ln.wf02.wt02(timestamp, status,
hardware) values (2, fa
IoTDB > insert into root.ln.wf02.wt02(timestamp, status, hardware) VALUES (3,
false, 'v3'),(4, true, 'v4')
```
+在树模型写入数据时，timestamp 与 time 均可作为时间列标识用于 INSERT 语句，书写时无需刻意区分；但查询结果中，时间列统一展示为
Time（固定名称），保证结果格式统一。
+
插入数据后我们可以使用 SELECT 语句简单查询已插入的数据。
```sql
