From b9af606593617a537b51bb3ff20fb3c25b45a251 Mon Sep 17 00:00:00 2001 From: W1y1r <2730956796@qq.com> Date: Wed, 19 Feb 2025 09:43:29 +0800 Subject: [PATCH] Optimization modeling scheme design document --- .../Data-Model-and-Terminology_apache.md | 30 ++++++------- .../Data-Model-and-Terminology_timecho.md | 42 +++++++++---------- .../Data-Model-and-Terminology_apache.md | 30 ++++++------- .../Data-Model-and-Terminology_timecho.md | 42 +++++++++---------- 4 files changed, 72 insertions(+), 72 deletions(-) diff --git a/src/zh/UserGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_apache.md b/src/zh/UserGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_apache.md index 97e0bcf5f..f55ef4bb5 100644 --- a/src/zh/UserGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_apache.md +++ b/src/zh/UserGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_apache.md @@ -80,7 +80,7 @@ - 在通过客户端工具 Cli 或 SDK 建立数据库连接时，需要通过 sql_dialect 参数指定使用的模型语法（默认使用树语法进行操作）。 -## 应用场景 +## 3 应用场景 应用场景主要包括两类： @@ -89,9 +89,9 @@ - 场景二：使用表模型进行数据的读写 -### 3 场景一：树模型 +### 3.1 场景一：树模型 -#### 3.1 特点 +#### 3.1.1 特点 - 简单直观，和物理世界的监测点位一一对应 @@ -99,7 +99,7 @@ - 适用 DCS、SCADA 等工业监控场景 -#### 3.2 基础概念 +#### 3.1.2 基础概念 | **概念** | **定义** | | -------------------- | ------------------------------------------------------------ | @@ -107,9 +107,9 @@ | **时间序列（测点）** | 定义：
1. 一个以数据库路径为前缀的、由 . 分割的路径，可包含任意多个层级，如 root.db.turbine.device1.metric1
2. 每个时间序列可以有不同的数据类型。
命名推荐:
1. 仅将唯一定位时间序列的标签（类似联合主键）放入路径中，一般不超过10层
2. 通常将基数（不同的取值数量）少的标签放在前面，便于系统将公共前缀进行压缩
数量推荐:
1. 集群可管理的时间序列总量和总内存相关，可参考资源推荐章节
2. 任一层级的子节点数量没有限制
创建方式：可手动创建或在数据写入时自动创建。 | | **设备** | 定义：倒数第二级为设备，如 root.db.turbine.**device1**.metric1中的“device1”这一层级即为设备
创建方式：无法仅创建设备，随时间序列创建而存在 | -#### 3.3 建模示例 +#### 3.1.3 建模示例 -##### 3.3.1 有多种类型的设备需要管理，如何建模？ +##### 3.1.3.1 有多种类型的设备需要管理，如何建模？ - 如场景中不同类型的设备具备不同的层级路径和测点集合，可以在数据库节点下按设备类型创建分支。每种设备下可以有不同的测点结构。 @@ -117,7 +117,7 @@ -##### 3.3.2 如果场景中没有设备，只有测点，如何建模？ +##### 3.1.3.2 如果场景中没有设备，只有测点，如何建模？ - 如场站的监控系统中，每个测点都有唯一编号，但无法对应到某些设备。 @@ -125,7 +125,7 @@ -##### 3.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ +##### 3.1.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ - 如在储能场景中，每一层结构都要监控其电压和电流，可以采用如下建模方式。 @@ -134,15 +134,15 @@ -### 4 场景二：表模型 +### 3.2 场景二：表模型 -#### 4.1 特点 +#### 3.2.1 特点 - 以时序表建模管理设备时序数据，便于使用标准 SQL 进行分析 - 适用于设备数据分析或从其他数据库迁移至 IoTDB 的场景 -#### 4.2 基础概念 +#### 3.2.2 基础概念 - 数据库：可管理多类设备 @@ -158,9 +158,9 @@ 数据筛选效率：时间列=标签列>属性列>测点列 -#### 4.3 建模示例 +#### 3.2.3 建模示例 -##### 4.3.1 有多种类型的设备需要管理，如何建模？ +##### 3.2.3.1 有多种类型的设备需要管理，如何建模？ - 推荐为每一类型的设备建立一张表，每个表可以具有不同的标签和测点集合。 - 即使设备之间有联系，或有层级关系，也推荐为每一类设备建一张表。 @@ -169,7 +169,7 @@ -##### 4.3.2 如果没有设备标识列和属性列，如何建模？ +##### 3.2.3.2 如果没有设备标识列和属性列，如何建模？ - 列数没有数量限制，可以达到数十万以上。 @@ -177,7 +177,7 @@ -##### 4.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ +##### 3.2.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ - 每个设备有多个子设备及测点信息，推荐为每类设备建一个表进行管理。 diff --git a/src/zh/UserGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_timecho.md b/src/zh/UserGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_timecho.md index e28b2fb15..6032862fd 100644 --- a/src/zh/UserGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_timecho.md +++ b/src/zh/UserGuide/Master/Table/Background-knowledge/Data-Model-and-Terminology_timecho.md @@ -80,7 +80,7 @@ - 在通过客户端工具 Cli 或 SDK 建立数据库连接时，需要通过 sql_dialect 参数指定使用的模型语法（默认使用树语法进行操作）。 -## 应用场景 +## 3 应用场景 应用场景主要包括三类： @@ -90,9 +90,9 @@ - 场景三：共用一份数据，使用树模型进行数据读写、使用表模型进行数据分析 -### 3 场景一：树模型 +### 3.1 场景一：树模型 -#### 3.1 特点 +#### 3.1.1 特点 - 简单直观，和物理世界的监测点位一一对应 @@ -100,7 +100,7 @@ - 适用 DCS、SCADA 等工业监控场景 -#### 3.2 基础概念 +#### 3.1.2 基础概念 | **概念** | **定义** | | -------------------- | ------------------------------------------------------------ | @@ -108,9 +108,9 @@ | **时间序列（测点）** | 定义：
1. 一个以数据库路径为前缀的、由 . 分割的路径，可包含任意多个层级，如 root.db.turbine.device1.metric1
2. 每个时间序列可以有不同的数据类型。
命名推荐:
1. 仅将唯一定位时间序列的标签（类似联合主键）放入路径中，一般不超过10层
2. 通常将基数（不同的取值数量）少的标签放在前面，便于系统将公共前缀进行压缩
数量推荐:
1. 集群可管理的时间序列总量和总内存相关，可参考资源推荐章节
2. 任一层级的子节点数量没有限制
创建方式：可手动创建或在数据写入时自动创建。 | | **设备** | 定义：倒数第二级为设备，如 root.db.turbine.**device1**.metric1中的“device1”这一层级即为设备
创建方式：无法仅创建设备，随时间序列创建而存在 | -#### 3.3 建模示例 +#### 3.1.3 建模示例 -##### 3.3.1 有多种类型的设备需要管理，如何建模？ +##### 3.1.3.1 有多种类型的设备需要管理，如何建模？ - 如场景中不同类型的设备具备不同的层级路径和测点集合，可以在数据库节点下按设备类型创建分支。每种设备下可以有不同的测点结构。 @@ -118,7 +118,7 @@ -##### 3.3.2 如果场景中没有设备，只有测点，如何建模？ +##### 3.1.3.2 如果场景中没有设备，只有测点，如何建模？ - 如场站的监控系统中，每个测点都有唯一编号，但无法对应到某些设备。 @@ -126,7 +126,7 @@ -##### 3.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ +##### 3.1.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ - 如在储能场景中，每一层结构都要监控其电压和电流，可以采用如下建模方式。 @@ -135,15 +135,15 @@ -### 4 场景二：表模型 +### 3.2 场景二：表模型 -#### 4.1 特点 +#### 3.2.1 特点 - 以时序表建模管理设备时序数据，便于使用标准 SQL 进行分析 - 适用于设备数据分析或从其他数据库迁移至 IoTDB 的场景 -#### 4.2 基础概念 +#### 3.2.2 基础概念 - 数据库：可管理多类设备 @@ -159,9 +159,9 @@ 数据筛选效率：时间列=标签列>属性列>测点列 -#### 4.3 建模示例 +#### 3.2.3 建模示例 -##### 4.3.1 有多种类型的设备需要管理，如何建模？ +##### 3.2.3.1 有多种类型的设备需要管理，如何建模？ - 推荐为每一类型的设备建立一张表，每个表可以具有不同的标签和测点集合。 - 即使设备之间有联系，或有层级关系，也推荐为每一类设备建一张表。 @@ -170,7 +170,7 @@ -##### 4.3.2 如果没有设备标识列和属性列，如何建模？ +##### 3.2.3.2 如果没有设备标识列和属性列，如何建模？ - 列数没有数量限制，可以达到数十万以上。 @@ -178,7 +178,7 @@ -##### 4.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ +##### 3.2.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ - 每个设备有多个子设备及测点信息，推荐为每类设备建一个表进行管理。 @@ -186,9 +186,9 @@ -### 5 场景三：双模型结合（企业版功能） +### 3.3 场景三：双模型结合（企业版功能） -#### 5.1 特点 +#### 3.3.1 特点 - 巧妙融合了树模型与表模型的优点，共用一份数据，写入灵活，查询丰富。 @@ -196,9 +196,9 @@ - 数据分析阶段，采用表模型语法，允许用户通过标准 SQL 查询语言，执行复杂的数据分析。 -#### 5.2 建模示例 +#### 3.3.2 建模示例 -##### 5.2.1 有多种类型的设备需要管理，如何建模？ +##### 3.3.2.1 有多种类型的设备需要管理，如何建模？ - 场景中不同类型的设备具备不同的层级路径和测点集合。 @@ -210,7 +210,7 @@ -##### 5.2.2 如果没有设备标识列和属性列，如何建模？ +##### 3.3.2.2 如果没有设备标识列和属性列，如何建模？ - 树模型：每个测点都有唯一编号，但无法对应到某些设备。 @@ -220,7 +220,7 @@ -##### 5.2.3 如果在一个设备下，既有子设备，也有测点，如何建模？ +##### 3.3.2.3 如果在一个设备下，既有子设备，也有测点，如何建模？ - 树模型：按照物理世界的监测点，对每一层结构进行建模。 diff --git a/src/zh/UserGuide/latest-Table/Background-knowledge/Data-Model-and-Terminology_apache.md b/src/zh/UserGuide/latest-Table/Background-knowledge/Data-Model-and-Terminology_apache.md index 97e0bcf5f..f55ef4bb5 100644 --- a/src/zh/UserGuide/latest-Table/Background-knowledge/Data-Model-and-Terminology_apache.md +++ b/src/zh/UserGuide/latest-Table/Background-knowledge/Data-Model-and-Terminology_apache.md @@ -80,7 +80,7 @@ - 在通过客户端工具 Cli 或 SDK 建立数据库连接时，需要通过 sql_dialect 参数指定使用的模型语法（默认使用树语法进行操作）。 -## 应用场景 +## 3 应用场景 应用场景主要包括两类： @@ -89,9 +89,9 @@ - 场景二：使用表模型进行数据的读写 -### 3 场景一：树模型 +### 3.1 场景一：树模型 -#### 3.1 特点 +#### 3.1.1 特点 - 简单直观，和物理世界的监测点位一一对应 @@ -99,7 +99,7 @@ - 适用 DCS、SCADA 等工业监控场景 -#### 3.2 基础概念 +#### 3.1.2 基础概念 | **概念** | **定义** | | -------------------- | ------------------------------------------------------------ | @@ -107,9 +107,9 @@ | **时间序列（测点）** | 定义：
1. 一个以数据库路径为前缀的、由 . 分割的路径，可包含任意多个层级，如 root.db.turbine.device1.metric1
2. 每个时间序列可以有不同的数据类型。
命名推荐:
1. 仅将唯一定位时间序列的标签（类似联合主键）放入路径中，一般不超过10层
2. 通常将基数（不同的取值数量）少的标签放在前面，便于系统将公共前缀进行压缩
数量推荐:
1. 集群可管理的时间序列总量和总内存相关，可参考资源推荐章节
2. 任一层级的子节点数量没有限制
创建方式：可手动创建或在数据写入时自动创建。 | | **设备** | 定义：倒数第二级为设备，如 root.db.turbine.**device1**.metric1中的“device1”这一层级即为设备
创建方式：无法仅创建设备，随时间序列创建而存在 | -#### 3.3 建模示例 +#### 3.1.3 建模示例 -##### 3.3.1 有多种类型的设备需要管理，如何建模？ +##### 3.1.3.1 有多种类型的设备需要管理，如何建模？ - 如场景中不同类型的设备具备不同的层级路径和测点集合，可以在数据库节点下按设备类型创建分支。每种设备下可以有不同的测点结构。 @@ -117,7 +117,7 @@ -##### 3.3.2 如果场景中没有设备，只有测点，如何建模？ +##### 3.1.3.2 如果场景中没有设备，只有测点，如何建模？ - 如场站的监控系统中，每个测点都有唯一编号，但无法对应到某些设备。 @@ -125,7 +125,7 @@ -##### 3.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ +##### 3.1.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ - 如在储能场景中，每一层结构都要监控其电压和电流，可以采用如下建模方式。 @@ -134,15 +134,15 @@ -### 4 场景二：表模型 +### 3.2 场景二：表模型 -#### 4.1 特点 +#### 3.2.1 特点 - 以时序表建模管理设备时序数据，便于使用标准 SQL 进行分析 - 适用于设备数据分析或从其他数据库迁移至 IoTDB 的场景 -#### 4.2 基础概念 +#### 3.2.2 基础概念 - 数据库：可管理多类设备 @@ -158,9 +158,9 @@ 数据筛选效率：时间列=标签列>属性列>测点列 -#### 4.3 建模示例 +#### 3.2.3 建模示例 -##### 4.3.1 有多种类型的设备需要管理，如何建模？ +##### 3.2.3.1 有多种类型的设备需要管理，如何建模？ - 推荐为每一类型的设备建立一张表，每个表可以具有不同的标签和测点集合。 - 即使设备之间有联系，或有层级关系，也推荐为每一类设备建一张表。 @@ -169,7 +169,7 @@ -##### 4.3.2 如果没有设备标识列和属性列，如何建模？ +##### 3.2.3.2 如果没有设备标识列和属性列，如何建模？ - 列数没有数量限制，可以达到数十万以上。 @@ -177,7 +177,7 @@ -##### 4.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ +##### 3.2.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ - 每个设备有多个子设备及测点信息，推荐为每类设备建一个表进行管理。 diff --git a/src/zh/UserGuide/latest-Table/Background-knowledge/Data-Model-and-Terminology_timecho.md b/src/zh/UserGuide/latest-Table/Background-knowledge/Data-Model-and-Terminology_timecho.md index e28b2fb15..6032862fd 100644 --- a/src/zh/UserGuide/latest-Table/Background-knowledge/Data-Model-and-Terminology_timecho.md +++ b/src/zh/UserGuide/latest-Table/Background-knowledge/Data-Model-and-Terminology_timecho.md @@ -80,7 +80,7 @@ - 在通过客户端工具 Cli 或 SDK 建立数据库连接时，需要通过 sql_dialect 参数指定使用的模型语法（默认使用树语法进行操作）。 -## 应用场景 +## 3 应用场景 应用场景主要包括三类： @@ -90,9 +90,9 @@ - 场景三：共用一份数据，使用树模型进行数据读写、使用表模型进行数据分析 -### 3 场景一：树模型 +### 3.1 场景一：树模型 -#### 3.1 特点 +#### 3.1.1 特点 - 简单直观，和物理世界的监测点位一一对应 @@ -100,7 +100,7 @@ - 适用 DCS、SCADA 等工业监控场景 -#### 3.2 基础概念 +#### 3.1.2 基础概念 | **概念** | **定义** | | -------------------- | ------------------------------------------------------------ | @@ -108,9 +108,9 @@ | **时间序列（测点）** | 定义：
1. 一个以数据库路径为前缀的、由 . 分割的路径，可包含任意多个层级，如 root.db.turbine.device1.metric1
2. 每个时间序列可以有不同的数据类型。
命名推荐:
1. 仅将唯一定位时间序列的标签（类似联合主键）放入路径中，一般不超过10层
2. 通常将基数（不同的取值数量）少的标签放在前面，便于系统将公共前缀进行压缩
数量推荐:
1. 集群可管理的时间序列总量和总内存相关，可参考资源推荐章节
2. 任一层级的子节点数量没有限制
创建方式：可手动创建或在数据写入时自动创建。 | | **设备** | 定义：倒数第二级为设备，如 root.db.turbine.**device1**.metric1中的“device1”这一层级即为设备
创建方式：无法仅创建设备，随时间序列创建而存在 | -#### 3.3 建模示例 +#### 3.1.3 建模示例 -##### 3.3.1 有多种类型的设备需要管理，如何建模？ +##### 3.1.3.1 有多种类型的设备需要管理，如何建模？ - 如场景中不同类型的设备具备不同的层级路径和测点集合，可以在数据库节点下按设备类型创建分支。每种设备下可以有不同的测点结构。 @@ -118,7 +118,7 @@ -##### 3.3.2 如果场景中没有设备，只有测点，如何建模？ +##### 3.1.3.2 如果场景中没有设备，只有测点，如何建模？ - 如场站的监控系统中，每个测点都有唯一编号，但无法对应到某些设备。 @@ -126,7 +126,7 @@ -##### 3.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ +##### 3.1.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ - 如在储能场景中，每一层结构都要监控其电压和电流，可以采用如下建模方式。 @@ -135,15 +135,15 @@ -### 4 场景二：表模型 +### 3.2 场景二：表模型 -#### 4.1 特点 +#### 3.2.1 特点 - 以时序表建模管理设备时序数据，便于使用标准 SQL 进行分析 - 适用于设备数据分析或从其他数据库迁移至 IoTDB 的场景 -#### 4.2 基础概念 +#### 3.2.2 基础概念 - 数据库：可管理多类设备 @@ -159,9 +159,9 @@ 数据筛选效率：时间列=标签列>属性列>测点列 -#### 4.3 建模示例 +#### 3.2.3 建模示例 -##### 4.3.1 有多种类型的设备需要管理，如何建模？ +##### 3.2.3.1 有多种类型的设备需要管理，如何建模？ - 推荐为每一类型的设备建立一张表，每个表可以具有不同的标签和测点集合。 - 即使设备之间有联系，或有层级关系，也推荐为每一类设备建一张表。 @@ -170,7 +170,7 @@ -##### 4.3.2 如果没有设备标识列和属性列，如何建模？ +##### 3.2.3.2 如果没有设备标识列和属性列，如何建模？ - 列数没有数量限制，可以达到数十万以上。 @@ -178,7 +178,7 @@ -##### 4.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ +##### 3.2.3.3 如果在一个设备下，既有子设备，也有测点，如何建模？ - 每个设备有多个子设备及测点信息，推荐为每类设备建一个表进行管理。 @@ -186,9 +186,9 @@ -### 5 场景三：双模型结合（企业版功能） +### 3.3 场景三：双模型结合（企业版功能） -#### 5.1 特点 +#### 3.3.1 特点 - 巧妙融合了树模型与表模型的优点，共用一份数据，写入灵活，查询丰富。 @@ -196,9 +196,9 @@ - 数据分析阶段，采用表模型语法，允许用户通过标准 SQL 查询语言，执行复杂的数据分析。 -#### 5.2 建模示例 +#### 3.3.2 建模示例 -##### 5.2.1 有多种类型的设备需要管理，如何建模？ +##### 3.3.2.1 有多种类型的设备需要管理，如何建模？ - 场景中不同类型的设备具备不同的层级路径和测点集合。 @@ -210,7 +210,7 @@ -##### 5.2.2 如果没有设备标识列和属性列，如何建模？ +##### 3.3.2.2 如果没有设备标识列和属性列，如何建模？ - 树模型：每个测点都有唯一编号，但无法对应到某些设备。 @@ -220,7 +220,7 @@ -##### 5.2.3 如果在一个设备下，既有子设备，也有测点，如何建模？ +##### 3.3.2.3 如果在一个设备下，既有子设备，也有测点，如何建模？ - 树模型：按照物理世界的监测点，对每一层结构进行建模。