apache · qiaojialin · Mar 4, 2025 · Mar 3, 2025
diff --git a/src/zh/UserGuide/Master/Table/API/Programming-JDBC_apache.md b/src/zh/UserGuide/Master/Table/API/Programming-JDBC_apache.md
@@ -21,15 +21,15 @@
 
 # JDBC接口
 
-## 1 功能介绍
+## 1. 功能介绍
 
 IoTDB JDBC接口提供了一种标准的方式来与IoTDB数据库进行交互，允许用户通过Java程序执行SQL语句来管理数据库和时间序列数据。它支持数据库的连接、创建、查询、更新和删除操作，以及时间序列数据的批量插入和查询。
 
 **注意**: 目前的JDBC实现仅是为与第三方工具连接使用的。使用JDBC（执行插入语句时）无法提供高性能写入。
 
 对于Java应用，我们推荐使用Java 原生接口。
 
-## 2 使用方式
+## 2. 使用方式
 
 **环境要求:**
 
@@ -48,7 +48,7 @@ IoTDB JDBC接口提供了一种标准的方式来与IoTDB数据库进行交互
 </dependencies>
 ```
 
-## 3 读写操作
+## 3. 读写操作
 
 ### 3.1 功能说明
 
@@ -68,7 +68,7 @@ IoTDB JDBC接口提供了一种标准的方式来与IoTDB数据库进行交互
 | ResultSet.next()                                             | 移动到结果集的下一行               | 无                                                         | boolean: 是否成功移动到下一行       |
 | ResultSet.getString(int columnIndex)                         | 获取指定列的字符串值               | columnIndex: 列索引（从1开始）                             | String: 列的字符串值                |
 
-## 4 示例代码
+## 4. 示例代码
 
 **注意：使用表模型，必须在 url 中指定 sql_dialect 参数为 table。**
 

diff --git a/src/zh/UserGuide/Master/Table/API/Programming-JDBC_timecho.md b/src/zh/UserGuide/Master/Table/API/Programming-JDBC_timecho.md
@@ -21,15 +21,15 @@
 
 # JDBC接口
 
-## 1 功能介绍
+## 1. 功能介绍
 
 IoTDB JDBC接口提供了一种标准的方式来与IoTDB数据库进行交互，允许用户通过Java程序执行SQL语句来管理数据库和时间序列数据。它支持数据库的连接、创建、查询、更新和删除操作，以及时间序列数据的批量插入和查询。
 
 **注意**: 目前的JDBC实现仅是为与第三方工具连接使用的。使用JDBC（执行插入语句时）无法提供高性能写入。
 
 对于Java应用，我们推荐使用Java 原生接口。
 
-## 2 使用方式
+## 2. 使用方式
 
 **环境要求:**
 
@@ -48,7 +48,7 @@ IoTDB JDBC接口提供了一种标准的方式来与IoTDB数据库进行交互
 </dependencies>
 ```
 
-## 3 读写操作
+## 3. 读写操作
 
 ### 3.1 功能说明
 
@@ -68,7 +68,7 @@ IoTDB JDBC接口提供了一种标准的方式来与IoTDB数据库进行交互
 | ResultSet.next()                                             | 移动到结果集的下一行               | 无                                                         | boolean: 是否成功移动到下一行       |
 | ResultSet.getString(int columnIndex)                         | 获取指定列的字符串值               | columnIndex: 列索引（从1开始）                             | String: 列的字符串值                |
 
-## 4 示例代码
+## 4. 示例代码
 
 **注意：使用表模型，必须在 url 中指定 sql_dialect 参数为 table。**
 

diff --git a/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md b/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_apache.md
@@ -21,11 +21,11 @@
 
 # Java Session原生接口 
 
-## 1 功能介绍
+## 1. 功能介绍
 
 IoTDB具备Java原生客户端驱动和对应的连接池，提供对象化接口，可以直接组装时序对象进行写入，无需拼装 SQL。推荐使用连接池，多线程并行操作数据库。
 
-## 2 使用方式
+## 2. 使用方式
 
 **环境要求:**
 
@@ -44,7 +44,7 @@ IoTDB具备Java原生客户端驱动和对应的连接池，提供对象化接
 </dependencies>
 ```
 
-## 3 读写操作
+## 3. 读写操作
 
 ### 3.1 ITableSession接口
 
@@ -348,7 +348,7 @@ public class TableSessionBuilder {
 }
 ```
 
-## 4 客户端连接池
+## 4. 客户端连接池
 
 ### 4.1 ITableSessionPool 接口
 
@@ -627,7 +627,7 @@ public class TableSessionPoolBuilder {
 }
 ```
 
-## 5 示例代码
+## 5. 示例代码
 
 Session 示例代码：[src/main/java/org/apache/iotdb/TableModelSessionExample.java](https://github.com/apache/iotdb/blob/master/example/session/src/main/java/org/apache/iotdb/TableModelSessionExample.java)
 

diff --git a/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md b/src/zh/UserGuide/Master/Table/API/Programming-Java-Native-API_timecho.md
@@ -21,11 +21,11 @@
 
 # Java Session原生接口 
 
-## 1 功能介绍
+## 1. 功能介绍
 
 IoTDB具备Java原生客户端驱动和对应的连接池，提供对象化接口，可以直接组装时序对象进行写入，无需拼装 SQL。推荐使用连接池，多线程并行操作数据库。
 
-## 2 使用方式
+## 2. 使用方式
 
 **环境要求:**
 
@@ -44,7 +44,7 @@ IoTDB具备Java原生客户端驱动和对应的连接池，提供对象化接
 </dependencies>
 ```
 
-## 3 读写操作
+## 3. 读写操作
 
 ### 3.1 ITableSession接口
 
@@ -348,7 +348,7 @@ public class TableSessionBuilder {
 }
 ```
 
-## 4 客户端连接池
+## 4. 客户端连接池
 
 ### 4.1 ITableSessionPool 接口
 
@@ -627,7 +627,7 @@ public class TableSessionPoolBuilder {
 }
 ```
 
-## 5 示例代码
+## 5. 示例代码
 
 Session 示例代码：[src/main/java/org/apache/iotdb/TableModelSessionExample.java](https://github.com/apache/iotdb/blob/master/example/session/src/main/java/org/apache/iotdb/TableModelSessionExample.java)
 

diff --git a/src/zh/UserGuide/Master/Table/API/Programming-Python-Native-API.md b/src/zh/UserGuide/Master/Table/API/Programming-Python-Native-API.md
@@ -21,15 +21,15 @@
 
 # Python 原生接口
 
-## 1 使用方式
+## 1. 使用方式
 
 安装依赖包:
 
 ```Java
 pip3 install apache-iotdb
 ```
 
-## 2 读写操作
+## 2. 读写操作
 
 ### 2.1 TableSession
 
@@ -168,7 +168,7 @@ class TableSessionConfig(object):
 
 在使用完 TableSession 后，务必调用 close 方法来释放资源。
 
-## 3 客户端连接池
+## 3. 客户端连接池
 
 ### 3.1 TableSessionPool
 
@@ -287,7 +287,7 @@ class TableSessionPoolConfig(object):
     """
 ```
 
-## 4 示例代码
+## 4. 示例代码
 
 Session示例代码:[iotdb/blob/master/iotdb-client/client-py/table_model_session_example.py](https://github.com/apache/iotdb/blob/master/iotdb-client/client-py/table_model_session_example.py)
 

diff --git a/src/zh/UserGuide/Master/Table/API/RestServiceV1.md b/src/zh/UserGuide/Master/Table/API/RestServiceV1.md
@@ -23,15 +23,15 @@
 
 IoTDB 的 RESTful 服务可用于查询、写入和管理操作，它使用 OpenAPI 标准来定义接口并生成框架。
 
-## 1 开启 RESTful 服务
+## 1. 开启 RESTful 服务
 
 Restful 服务默认情况是关闭的，开启 restful 功能需要找到 IoTDB 安装目录下的`conf/iotdb-system.properties`文件，将 `enable_rest_service` 设置为 `true` ，然后重启 datanode 进程。
 
 ```Plain
  enable_rest_service=true
 ```
 
-## 2 鉴权
+## 2. 鉴权
 
 除了检活接口 `/ping`，restful服务使用了基础（basic）鉴权，每次 URL 请求都需要在 header 中携带 `'Authorization':'Basic' + base64.encode(username + ':' + password)`。
 
@@ -57,7 +57,7 @@ Authorization : Basic cm9vdDpyb290
 {"code":800,"message":"INIT_AUTH_ERROR"}
 ```
 
-## 3 接口定义
+## 3. 接口定义
 
 ### 3.1 ping
 
@@ -251,7 +251,7 @@ curl -H "Content-Type:application/json" -H "Authorization:Basic cm9vdDpyb290" -X
 ```
 
 
-## 4 配置
+## 4. 配置
 
 配置文件位于 `iotdb-system.properties` 中。
 

diff --git a/src/zh/UserGuide/Master/Table/Background-knowledge/Cluster-Concept_apache.md b/src/zh/UserGuide/Master/Table/Background-knowledge/Cluster-Concept_apache.md
@@ -21,7 +21,7 @@
 
 # 常见概念
 
-## 1 数据模型相关概念 
+## 1. 数据模型相关概念 
 
 ### 1.1 数据模型（sql_dialect）
 
@@ -48,7 +48,7 @@ IoTDB 支持两种时序数据模型（SQL语法），管理的对象均为设
 
 IoTDB 在数据编码后，使用压缩技术进一步压缩二进制数据，提升存储效率。IoTDB 支持多种压缩方法，详细信息请查看：[压缩和编码](../Technical-Insider/Encoding-and-Compression.md)。
 
-## 2 分布式相关概念
+## 2. 分布式相关概念
 
 下图展示了一个常见的 IoTDB 3C3D（3 个 ConfigNode、3 个 DataNode）的集群部署模式：                 
 
@@ -89,7 +89,7 @@ IoTDB 集群包括三种节点（进程）：ConfigNode（管理节点），Data
 | 数据   | data_replication_factor   | 1            | 2            |
 
 
-## 3 部署相关概念
+## 3. 部署相关概念
 
 IoTDB 有两种运行模式：单机模式、集群模式。
 

diff --git a/src/zh/UserGuide/Master/Table/Background-knowledge/Cluster-Concept_timecho.md b/src/zh/UserGuide/Master/Table/Background-knowledge/Cluster-Concept_timecho.md
@@ -21,7 +21,7 @@
 
 # 常见概念
 
-## 1 数据模型相关概念 
+## 1. 数据模型相关概念 
 
 ### 1.1 数据模型（sql_dialect）
 
@@ -48,7 +48,7 @@ IoTDB 支持两种时序数据模型（SQL语法），管理的对象均为设
 
 IoTDB 在数据编码后，使用压缩技术进一步压缩二进制数据，提升存储效率。IoTDB 支持多种压缩方法，详细信息请查看：[压缩和编码](../Technical-Insider/Encoding-and-Compression.md)。
 
-## 2 分布式相关概念
+## 2. 分布式相关概念
 
 下图展示了一个常见的 IoTDB 3C3D（3 个 ConfigNode、3 个 DataNode）的集群部署模式：                 
 
@@ -89,7 +89,7 @@ IoTDB 集群包括三种节点（进程）：ConfigNode（管理节点），Data
 | 数据   | data_replication_factor   | 1            | 2            |
 
 
-## 3 部署相关概念
+## 3. 部署相关概念
 
 IoTDB 有三种运行模式：单机模式、集群模式和双活模式。
 

diff --git a/...serGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_apache.md b/...serGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_apache.md
@@ -23,11 +23,11 @@
 
 本章节主要介绍如何将时序数据应用场景转化为IoTDB时序建模。
 
-## 1 时序数据模型
+## 1. 时序数据模型
 
 在构建IoTDB建模方案前，需要先了解时序数据和时序数据模型，详细内容见此页面：[时序数据模型](../Background-knowledge/Navigating_Time_Series_Data.md)
 
-## 2 IoTDB 的两种时序模型
+## 2. IoTDB 的两种时序模型
 
 IoTDB 提供了两种数据建模方式——树模型和表模型，其特点分别如下：
 
@@ -80,7 +80,7 @@ IoTDB 提供了两种数据建模方式——树模型和表模型，其特点
 - 在通过客户端工具 Cli 或 SDK 建立数据库连接时，需要通过 sql_dialect 参数指定使用的模型语法（默认使用树语法进行操作）。
 
 
-## 3 应用场景
+## 3. 应用场景
 
 应用场景主要包括两类：
 

diff --git a/...erGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_timecho.md b/...erGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_timecho.md
@@ -23,11 +23,11 @@
 
 本章节主要介绍如何将时序数据应用场景转化为IoTDB时序建模。
 
-## 1 时序数据模型
+## 1. 时序数据模型
 
 在构建IoTDB建模方案前，需要先了解时序数据和时序数据模型，详细内容见此页面：[时序数据模型](../Background-knowledge/Navigating_Time_Series_Data.md)
 
-## 2 IoTDB 的两种时序模型
+## 2. IoTDB 的两种时序模型
 
 IoTDB 提供了两种数据建模方式——树模型和表模型，其特点分别如下：
 
@@ -80,7 +80,7 @@ IoTDB 提供了两种数据建模方式——树模型和表模型，其特点
 - 在通过客户端工具 Cli 或 SDK 建立数据库连接时，需要通过 sql_dialect 参数指定使用的模型语法（默认使用树语法进行操作）。
 
 
-## 3 应用场景
+## 3. 应用场景
 
 应用场景主要包括三类：
 

diff --git a/src/zh/UserGuide/Master/Table/Background-knowledge/Data-Type.md b/src/zh/UserGuide/Master/Table/Background-knowledge/Data-Type.md
@@ -21,7 +21,7 @@
 
 # 数据类型
 
-## 1 基本数据类型
+## 1. 基本数据类型
 
 IoTDB 支持以下十种数据类型：
 
@@ -70,7 +70,7 @@ CREATE TIMESERIES root.vehicle.d0.s0 WITH DATATYPE=FLOAT, ENCODING=RLE, 'MAX_POI
 | TIMESTAMP    | INT32 INT64 TIMESTAMP             |
 | DATE         | DATE                              |
 
-## 2 时间戳类型
+## 2. 时间戳类型
 
 时间戳是一个数据到来的时间点，其中包括绝对时间戳和相对时间戳。
 

diff --git a/src/zh/UserGuide/Master/Table/Background-knowledge/Navigating_Time_Series_Data.md b/src/zh/UserGuide/Master/Table/Background-knowledge/Navigating_Time_Series_Data.md
@@ -20,7 +20,7 @@
 -->
 # 时序数据模型
 
-## 1 什么叫时序数据？
+## 1. 什么叫时序数据？
 
 万物互联的今天，物联网场景、工业场景等各类场景都在进行数字化转型，人们通过在各类设备上安装传感器对设备的各类状态进行采集。如电机采集电压、电流，风机的叶片转速、角速度、发电功率；车辆采集经纬度、速度、油耗；桥梁的振动频率、挠度、位移量等。传感器的数据采集，已经渗透在各个行业中。
 
@@ -33,7 +33,7 @@
 
 传感器产生的海量时序数据是各行各业数字化转型的基础，因此我们对时序数据的模型梳理主要围绕设备、传感器展开。
 
-## 2 时序数据中的关键概念有哪些？
+## 2. 时序数据中的关键概念有哪些？
 
 时序数据中主要涉及的概念如下。
 

diff --git a/src/zh/UserGuide/Master/Table/Basic-Concept/Database-Management.md b/src/zh/UserGuide/Master/Table/Basic-Concept/Database-Management.md
@@ -21,7 +21,7 @@
 
 # 数据库管理
 
-## 1 数据库管理
+## 1. 数据库管理
 
 ### 1.1 创建数据库
 

diff --git a/src/zh/UserGuide/Master/Table/Basic-Concept/Delete-Data.md b/src/zh/UserGuide/Master/Table/Basic-Concept/Delete-Data.md
@@ -21,7 +21,7 @@
 
 # 数据删除
 
-## 1 数据删除：
+## 1. 数据删除：
 
 数据删除可以通过 delete 语句来完成，其中可以通过指定标签和时间的过滤条件来删除部分数据。
 
@@ -92,7 +92,7 @@ DELETE FROM table1
 DELETE FROM table1 WHERE model_id = 'B'
 ```
 
-## 2 设备删除：
+## 2. 设备删除：
 
 当一个设备写入后，在 IoTDB 中即保留了其元数据，数据删除语句无法删除设备的元数据，可以使用设备删除语句删除设备的所有数据和元数据。