From 4675e27cd6875edd89c6ba1a1c52f794c9623de3 Mon Sep 17 00:00:00 2001 From: W1y1r <2730956796@qq.com> Date: Wed, 12 Feb 2025 17:01:37 +0800 Subject: [PATCH] Tsfle-2.x data model page reconstruction --- .../develop/QuickStart/Data-Model.md | 45 ++++------------- .../UserGuide/latest/QuickStart/Data-Model.md | 48 ++++--------------- 2 files changed, 18 insertions(+), 75 deletions(-) diff --git a/src/zh/UserGuide/develop/QuickStart/Data-Model.md b/src/zh/UserGuide/develop/QuickStart/Data-Model.md index f6a8bc142..5226df304 100644 --- a/src/zh/UserGuide/develop/QuickStart/Data-Model.md +++ b/src/zh/UserGuide/develop/QuickStart/Data-Model.md @@ -24,44 +24,17 @@ 为管理工业物联网时序数据，TsFile 的测点数据模型包含如下信息 -- 标签列：以字符串键值对形式对一维物联网设备的描述。例如，“category=XT451”表示风力涡轮机的类别为“XT451”，“year=2021”表示其建造于2021年。 -- 测点列：设备正在测量的变量。与风扇速度、电压、温度、风速等类似。与目前固定为STRING数据类型的标记不同，字段受各种数据类型的支持。 -- 时间戳和时间序列：设备测量的FIELD的每个值都与一个唯一的时间戳相关联。FIELD的时间戳和值的序列是一个时间序列。 -- 元数据：一组可以唯一标识一种设备的标签，以及由这些设备测量的字段集。例如，风力涡轮机可以通过“省”、“市”、“风场”和“序列号”进行唯一定位，因此方案“wind_turbine”的TAG集可以是“省”，“市”，“风场“和“序列编号”。而其FIELD集包含“风扇速度”、“电压”、“温度”、“风速”等。 -- 设备号：物联网设备的唯一标识符，由模式名称和所有标签值组成。例如，对于上述模式“wind_turbine”，DeviceId可以是（“wind_urbine”、“Beijing”、“Beijing_1135”、“T1523678”）。 - - - - - - - - - - - - - - - - - - - - - - - - - - -
概念定义
表一类具有相同模式的设备的集合。建模时定义的存储表由标识列、时间列和物理量列三部分组成。
标识列设备唯一标识，一个表内可包含0至多个标识列，标识列的值按建表时的列顺序组合形成的复合值称为标识，复合值相同的标识为同一标识。标识列的数据类型目前只能为String，可以不指定，默认为String标识列的值可以全为空写入时必须指定所有标识列（未指定的标识列默认使用 null 填充）
时间戳一个表必须有一列时间列，相同标识取值的数据默认按时间排序。时间列的值不能为空，必须顺序的。
测点列测点列定义了时序数据的测点名称、数据类型。
行表中的一行数据
- +| **概念** | **定义** | +| --------------------------- | ------------------------------------------------------------ | +| **表** | 具有相同模式的设备集合。
建模时定义的存储表由时间列、标签列和测点列三部分组成。| +| **时间列（TIME）** | 每个时序表必须有一个时间列，数据类型为 TIMESTAMP，名称可以自定义
时间列的值不能为空，必须顺序的。 | +| **标签列（TAG）** | 设备的唯一标识（联合主键），可以为 0 至多个
标识列的数据类型目前仅支持String，不指定时默认为String
标签信息不可修改和删除，但允许增加
推荐按粒度由大到小进行排列
写入时必须指定所有标识列（未指定的标识列默认使用 null 填充）| +| **测点列（FIELD）** | 一个设备采集的测点可以有1个至多个，值随时间变化
表的测点列没有数量限制，可以达到数十万以上
字段支持多种数据类型（与标签列固定为STRING类型不同）。 | ## 示例 -元数据描述的是具有相同模式的设备的集合。如下图所示，它模拟了工厂设备的管理，每个设备的物理量采集都具备一定共性（如都采集温度和湿度物理量、同一设备的物理量同频采集等），因此可以逐个设备进行管理。 +表描述的是具有相同标签的设备的集合。如下图所示，它模拟了工厂设备的管理，每个设备的物理量采集都具备一定共性（如都采集温度和湿度物理量、同一设备的物理量同频采集等），因此可以逐个设备进行管理。 -此时，物理设备可以通过3个标签[区域]-[工厂]-[设备]（下图中的橙色列，也称为设备标识信息）进行唯一标识。设备收集的字段为[温度]、[湿度]、[状态]和[到达时间]（下图中的蓝色列）。 +此时，物理设备可以通过3个标签【地区】-【工厂】-【设备】（下图橙色列，又称设备标签）进行唯一标识。设备最终采集的指标为【温度】、【湿度】、【状态】、【到达时间】（下图中的蓝色列）。 -![](https://alioss.timecho.com/docs/img/data_model_example_image-zh.png) \ No newline at end of file +![](https://alioss.timecho.com/docs/img/Data-model01.png) \ No newline at end of file diff --git a/src/zh/UserGuide/latest/QuickStart/Data-Model.md b/src/zh/UserGuide/latest/QuickStart/Data-Model.md index 1ecc1e58e..5226df304 100644 --- a/src/zh/UserGuide/latest/QuickStart/Data-Model.md +++ b/src/zh/UserGuide/latest/QuickStart/Data-Model.md @@ -24,47 +24,17 @@ 为管理工业物联网时序数据，TsFile 的测点数据模型包含如下信息 -- 标签列：以字符串键值对形式对一维物联网设备的描述。例如，“category=XT451”表示风力涡轮机的类别为“XT451”，“year=2021”表示其建造于2021年。 -- 测点列：设备正在测量的变量。与风扇速度、电压、温度、风速等类似。与目前固定为STRING数据类型的标记不同，字段受各种数据类型的支持。 -- 时间戳和时间序列：设备测量的FIELD的每个值都与一个唯一的时间戳相关联。FIELD的时间戳和值的序列是一个时间序列。 -- 元数据：一组可以唯一标识一种设备的标签，以及由这些设备测量的字段集。例如，风力涡轮机可以通过“省”、“市”、“风场”和“序列号”进行唯一定位，因此方案“wind_turbine”的TAG集可以是“省”，“市”，“风场“和“序列编号”。而其FIELD集包含“风扇速度”、“电压”、“温度”、“风速”等。 -- 设备号：物联网设备的唯一标识符，由模式名称和所有标签值组成。例如，对于上述模式“wind_turbine”，DeviceId可以是（“wind_urbine”、“Beijing”、“Beijing_1135”、“T1523678”）。 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
概念定义
表一类具有相同模式的设备的集合。建模时定义的存储表由标识列、时间列和物理量列三部分组成。
标识列设备唯一标识，一个表内可包含0至多个标识列，标识列的值按建表时的列顺序组合形成的复合值称为标识，复合值相同的标识为同一标识。标识列的数据类型目前只能为String，可以不指定，默认为String标识列的值可以全为空写入时必须指定所有标识列（未指定的标识列默认使用 null 填充）
时间戳一个表必须有一列时间列，相同标识取值的数据默认按时间排序。时间列的值不能为空，必须顺序的。
测点列测点列定义了时序数据的测点名称、数据类型。
行表中的一行数据
+| **概念** | **定义** | +| --------------------------- | ------------------------------------------------------------ | +| **表** | 具有相同模式的设备集合。
建模时定义的存储表由时间列、标签列和测点列三部分组成。| +| **时间列（TIME）** | 每个时序表必须有一个时间列，数据类型为 TIMESTAMP，名称可以自定义
时间列的值不能为空，必须顺序的。 | +| **标签列（TAG）** | 设备的唯一标识（联合主键），可以为 0 至多个
标识列的数据类型目前仅支持String，不指定时默认为String
标签信息不可修改和删除，但允许增加
推荐按粒度由大到小进行排列
写入时必须指定所有标识列（未指定的标识列默认使用 null 填充）| +| **测点列（FIELD）** | 一个设备采集的测点可以有1个至多个，值随时间变化
表的测点列没有数量限制，可以达到数十万以上
字段支持多种数据类型（与标签列固定为STRING类型不同）。 | ## 示例 -元数据描述的是具有相同模式的设备的集合。如下图所示，它模拟了工厂设备的管理，每个设备的物理量采集都具备一定共性（如都采集温度和湿度物理量、同一设备的物理量同频采集等），因此可以逐个设备进行管理。 +表描述的是具有相同标签的设备的集合。如下图所示，它模拟了工厂设备的管理，每个设备的物理量采集都具备一定共性（如都采集温度和湿度物理量、同一设备的物理量同频采集等），因此可以逐个设备进行管理。 -此时，物理设备可以通过3个标签[区域]-[工厂]-[设备]（下图中的橙色列，也称为设备标识信息）进行唯一标识。设备收集的字段为[温度]、[湿度]、[状态]和[到达时间]（下图中的蓝色列）。 +此时，物理设备可以通过3个标签【地区】-【工厂】-【设备】（下图橙色列，又称设备标签）进行唯一标识。设备最终采集的指标为【温度】、【湿度】、【状态】、【到达时间】（下图中的蓝色列）。 -![](https://alioss.timecho.com/docs/img/data_model_example_image-zh.png) \ No newline at end of file +![](https://alioss.timecho.com/docs/img/Data-model01.png) \ No newline at end of file