diff --git a/src/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_apache.md b/src/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_apache.md index de7833bcd..d2ebcb049 100644 --- a/src/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_apache.md +++ b/src/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_apache.md @@ -743,6 +743,37 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + The query result set is filtered by tags. For example: + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +The query results are as follows: + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + * SHOW LATEST TIMESERIES diff --git a/src/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_timecho.md b/src/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_timecho.md index f617f29e7..f2dbb7e36 100644 --- a/src/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_timecho.md +++ b/src/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_timecho.md @@ -745,6 +745,38 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + The query result set is filtered by tags. For example: + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +The query results are as follows: + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + + * SHOW LATEST TIMESERIES all the returned timeseries information should be sorted in descending order of the last timestamp of timeseries diff --git a/src/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_apache.md b/src/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_apache.md index 00bd8e68a..f74fccb53 100644 --- a/src/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_apache.md +++ b/src/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_apache.md @@ -743,6 +743,37 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + The query result set is filtered by tags. For example: + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + + The query results are as follows: + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + * SHOW LATEST TIMESERIES diff --git a/src/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_timecho.md b/src/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_timecho.md index 568b1ee04..6cba28693 100644 --- a/src/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_timecho.md +++ b/src/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_timecho.md @@ -745,6 +745,38 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + The query result set is filtered by tags. For example: + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +The query results are as follows: + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + + * SHOW LATEST TIMESERIES all the returned timeseries information should be sorted in descending order of the last timestamp of timeseries diff --git a/src/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_apache.md b/src/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_apache.md index 00bd8e68a..f74fccb53 100644 --- a/src/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_apache.md +++ b/src/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_apache.md @@ -743,6 +743,37 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + The query result set is filtered by tags. For example: + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + + The query results are as follows: + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + * SHOW LATEST TIMESERIES diff --git a/src/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_timecho.md b/src/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_timecho.md index 568b1ee04..6cba28693 100644 --- a/src/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_timecho.md +++ b/src/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_timecho.md @@ -745,6 +745,38 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + The query result set is filtered by tags. For example: + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +The query results are as follows: + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + + * SHOW LATEST TIMESERIES all the returned timeseries information should be sorted in descending order of the last timestamp of timeseries diff --git a/src/UserGuide/latest/Basic-Concept/Operate-Metadata_apache.md b/src/UserGuide/latest/Basic-Concept/Operate-Metadata_apache.md index de7833bcd..d2ebcb049 100644 --- a/src/UserGuide/latest/Basic-Concept/Operate-Metadata_apache.md +++ b/src/UserGuide/latest/Basic-Concept/Operate-Metadata_apache.md @@ -743,6 +743,37 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + The query result set is filtered by tags. For example: + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +The query results are as follows: + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + * SHOW LATEST TIMESERIES diff --git a/src/UserGuide/latest/Basic-Concept/Operate-Metadata_timecho.md b/src/UserGuide/latest/Basic-Concept/Operate-Metadata_timecho.md index f617f29e7..f2dbb7e36 100644 --- a/src/UserGuide/latest/Basic-Concept/Operate-Metadata_timecho.md +++ b/src/UserGuide/latest/Basic-Concept/Operate-Metadata_timecho.md @@ -745,6 +745,38 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + The query result set is filtered by tags. For example: + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +The query results are as follows: + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + + * SHOW LATEST TIMESERIES all the returned timeseries information should be sorted in descending order of the last timestamp of timeseries diff --git a/src/zh/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_apache.md b/src/zh/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_apache.md index fb469b6f9..bfb0391fc 100644 --- a/src/zh/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_apache.md +++ b/src/zh/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_apache.md @@ -141,9 +141,7 @@ It costs 0.002s ### 1.5 数据存活时间（TTL） -IoTDB 支持对 device 级别设置数据存活时间（TTL），这使得 IoTDB 可以定期、自动地删除一定时间之前的数据。合理使用 TTL -可以帮助您控制 IoTDB 占用的总磁盘空间以避免出现磁盘写满等异常。并且，随着文件数量的增多，查询性能往往随之下降， -内存占用也会有所提高。及时地删除一些较老的文件有助于使查询性能维持在一个较高的水平和减少内存资源的占用。 +IoTDB 支持对 device 级别设置数据存活时间（TTL），这使得 IoTDB 可以定期、自动地删除一定时间之前的数据。合理使用 TTL可以帮助您控制 IoTDB 占用的总磁盘空间以避免出现磁盘写满等异常。并且，随着文件数量的增多，查询性能往往随之下降，内存占用也会有所提高。及时地删除一些较老的文件有助于使查询性能维持在一个较高的水平和减少内存资源的占用。 TTL的默认单位为毫秒，如果配置文件中的时间精度修改为其他单位，设置ttl时仍然使用毫秒单位。 @@ -727,6 +725,37 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + 对查询结果集根据标签进行过滤。例如： + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +执行结果分别为： + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + * SHOW LATEST TIMESERIES 表示查询出的时间序列需要按照最近插入时间戳降序排列 @@ -986,7 +1015,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' ## 4. 路径查询 -### 路径（Path） +### 4.1 路径（Path） 路径（path）是用于表示时间序列的层级结构的表达式，其语法定义如下： ```SQL @@ -1004,7 +1033,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' | '**' ; ``` -### 路径结点名（NodeName） +### 4.2 路径结点名（NodeName） - 路径中由 `.` 分割的部分称为路径结点名（nodeName）。 - 例如，`root.a.b.c` 是一个层级为 4 的路径，其中 root、a、b 和 c 都是路径结点名。 @@ -1019,11 +1048,11 @@ IoTDB> show timeseries where TAGS(tag1)='v1' - UNICODE 中文字符（\u2E80 到 \u9FFF） - 大小写敏感性：在 Windows 系统上，数据库路径结点名是大小写不敏感的。例如，root.ln 和 root.LN 会被视为相同的路径。 -### 特殊字符（反引号） +### 4.3 特殊字符（反引号） 如果`路径结点名（NodeName）`中需要使用特殊字符（如空格、标点符号等），可以使用反引号（`）将结点名引用起来。更多关于反引号的使用方法，请参考[反引号](../SQL-Manual/Syntax-Rule.md#反引号)。 -### 路径模式（Path Pattern） +### 4.4 路径模式（Path Pattern） 为了使得在表达多个时间序列的时候更加方便快捷，IoTDB 为用户提供带通配符`*`或`**`的路径。通配符可以出现在路径中的任何层。 @@ -1036,7 +1065,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' **注意**：* 和 ** 不能放在路径的开头。 -### 查看路径的所有子路径 +### 4.5 查看路径的所有子路径 ``` SHOW CHILD PATHS pathPattern @@ -1072,7 +1101,7 @@ It costs 0.002s +---------------+ ``` -### 4.2 查看路径的下一级节点 +### 4.6 查看路径的下一级节点 ``` SHOW CHILD NODES pathPattern @@ -1103,7 +1132,7 @@ SHOW CHILD NODES pathPattern +------------+ ``` -### 4.3 统计节点数 +### 4.7 统计节点数 IoTDB 支持使用`COUNT NODES LEVEL=`来统计当前 Metadata 树下满足某路径模式的路径中指定层级的节点个数。这条语句可以用来统计带有特定采样点的设备数。例如： @@ -1153,7 +1182,7 @@ It costs 0.002s > 注意：时间序列的路径只是过滤条件，与 level 的定义无关。 -### 4.4 查看设备 +### 4.8 查看设备 * SHOW DEVICES pathPattern? (WITH DATABASE)? devicesWhereClause? limitClause? @@ -1265,7 +1294,7 @@ Total line number = 2 It costs 0.001s ``` -### 4.5 统计设备数量 +### 4.9 统计设备数量 * COUNT DEVICES \ diff --git a/src/zh/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_timecho.md b/src/zh/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_timecho.md index ddf31edd9..effb7c035 100644 --- a/src/zh/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_timecho.md +++ b/src/zh/UserGuide/Master/Tree/Basic-Concept/Operate-Metadata_timecho.md @@ -141,9 +141,7 @@ It costs 0.002s ### 1.5 数据存活时间（TTL） -IoTDB 支持对 device 级别设置数据存活时间（TTL），这使得 IoTDB 可以定期、自动地删除一定时间之前的数据。合理使用 TTL -可以帮助您控制 IoTDB 占用的总磁盘空间以避免出现磁盘写满等异常。并且，随着文件数量的增多，查询性能往往随之下降， -内存占用也会有所提高。及时地删除一些较老的文件有助于使查询性能维持在一个较高的水平和减少内存资源的占用。 +IoTDB 支持对 device 级别设置数据存活时间（TTL），这使得 IoTDB 可以定期、自动地删除一定时间之前的数据。合理使用 TTL可以帮助您控制 IoTDB 占用的总磁盘空间以避免出现磁盘写满等异常。并且，随着文件数量的增多，查询性能往往随之下降，内存占用也会有所提高。及时地删除一些较老的文件有助于使查询性能维持在一个较高的水平和减少内存资源的占用。 TTL的默认单位为毫秒，如果配置文件中的时间精度修改为其他单位，设置ttl时仍然使用毫秒单位。 @@ -726,12 +724,44 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + 对查询结果集根据标签进行过滤。例如： + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +执行结果分别为： + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + * SHOW LATEST TIMESERIES 表示查询出的时间序列需要按照最近插入时间戳降序排列 + 需要注意的是，当查询路径不存在时，系统会返回 0 条时间序列。 ### 3.5 统计时间序列总数 @@ -1027,7 +1057,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' ## 4. 路径查询 -### 路径（Path） +### 4.1 路径（Path） 路径（path）是用于表示时间序列的层级结构的表达式，其语法定义如下： ```SQL @@ -1045,7 +1075,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' | '**' ; ``` -### 路径结点名（NodeName） +### 4.2 路径结点名（NodeName） - 路径中由 `.` 分割的部分称为路径结点名（nodeName）。 - 例如，`root.a.b.c` 是一个层级为 4 的路径，其中 root、a、b 和 c 都是路径结点名。 @@ -1060,11 +1090,11 @@ IoTDB> show timeseries where TAGS(tag1)='v1' - UNICODE 中文字符（\u2E80 到 \u9FFF） - 大小写敏感性：在 Windows 系统上，数据库路径结点名是大小写不敏感的。例如，root.ln 和 root.LN 会被视为相同的路径。 -### 特殊字符（反引号） +### 4.3 特殊字符（反引号） 如果`路径结点名（NodeName）`中需要使用特殊字符（如空格、标点符号等），可以使用反引号（`）将结点名引用起来。更多关于反引号的使用方法，请参考[反引号](../SQL-Manual/Syntax-Rule.md#反引号)。 -### 路径模式（Path Pattern） +### 4.4 路径模式（Path Pattern） 为了使得在表达多个时间序列的时候更加方便快捷，IoTDB 为用户提供带通配符`*`或`**`的路径。通配符可以出现在路径中的任何层。 @@ -1077,7 +1107,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' **注意**：* 和 ** 不能放在路径的开头。 -### 查看路径的所有子路径 +### 4.5 查看路径的所有子路径 ``` SHOW CHILD PATHS pathPattern @@ -1113,7 +1143,7 @@ It costs 0.002s +---------------+ ``` -### 4.2 查看路径的下一级节点 +### 4.6 查看路径的下一级节点 ``` SHOW CHILD NODES pathPattern @@ -1144,7 +1174,7 @@ SHOW CHILD NODES pathPattern +------------+ ``` -### 4.3 统计节点数 +### 4.7 统计节点数 IoTDB 支持使用`COUNT NODES LEVEL=`来统计当前 Metadata 树下满足某路径模式的路径中指定层级的节点个数。这条语句可以用来统计带有特定采样点的设备数。例如： @@ -1194,7 +1224,7 @@ It costs 0.002s > 注意：时间序列的路径只是过滤条件，与 level 的定义无关。 -### 4.4 查看设备 +### 4.8 查看设备 * SHOW DEVICES pathPattern? (WITH DATABASE)? devicesWhereClause? limitClause? @@ -1306,7 +1336,7 @@ Total line number = 2 It costs 0.001s ``` -### 4.5 统计设备数量 +### 4.9 统计设备数量 * COUNT DEVICES \ @@ -1351,7 +1381,7 @@ Total line number = 1 It costs 0.004s ``` -### 4.6 活跃设备查询 +### 4.10 活跃设备查询 和活跃时间序列一样，我们可以在查看和统计设备的基础上添加时间过滤条件来查询在某段时间内存在数据的活跃设备。这里活跃的定义与活跃时间序列相同，使用样例如下： ``` IoTDB> insert into root.sg.data(timestamp, s1,s2) values(15000, 1, 2); diff --git a/src/zh/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_apache.md b/src/zh/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_apache.md index 1d4771d4e..84fff90ff 100644 --- a/src/zh/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_apache.md +++ b/src/zh/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_apache.md @@ -725,6 +725,38 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + 对查询结果集根据标签进行过滤。例如： + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +执行结果分别为： + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + + * SHOW LATEST TIMESERIES 表示查询出的时间序列需要按照最近插入时间戳降序排列 diff --git a/src/zh/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_timecho.md b/src/zh/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_timecho.md index 7bbe7801b..d8d79ebf6 100644 --- a/src/zh/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_timecho.md +++ b/src/zh/UserGuide/V1.3.x/Basic-Concept/Operate-Metadata_timecho.md @@ -723,6 +723,37 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + 对查询结果集根据标签进行过滤。例如： + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +执行结果分别为： + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + * SHOW LATEST TIMESERIES diff --git a/src/zh/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_apache.md b/src/zh/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_apache.md index ea83b049c..84fff90ff 100644 --- a/src/zh/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_apache.md +++ b/src/zh/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_apache.md @@ -141,9 +141,7 @@ It costs 0.002s ### 数据存活时间（TTL） -IoTDB 支持对 device 级别设置数据存活时间（TTL），这使得 IoTDB 可以定期、自动地删除一定时间之前的数据。合理使用 TTL -可以帮助您控制 IoTDB 占用的总磁盘空间以避免出现磁盘写满等异常。并且，随着文件数量的增多，查询性能往往随之下降， -内存占用也会有所提高。及时地删除一些较老的文件有助于使查询性能维持在一个较高的水平和减少内存资源的占用。 +IoTDB 支持对 device 级别设置数据存活时间（TTL），这使得 IoTDB 可以定期、自动地删除一定时间之前的数据。合理使用 TTL可以帮助您控制 IoTDB 占用的总磁盘空间以避免出现磁盘写满等异常。并且，随着文件数量的增多，查询性能往往随之下降，内存占用也会有所提高。及时地删除一些较老的文件有助于使查询性能维持在一个较高的水平和减少内存资源的占用。 TTL的默认单位为毫秒，如果配置文件中的时间精度修改为其他单位，设置ttl时仍然使用毫秒单位。 @@ -727,6 +725,38 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + 对查询结果集根据标签进行过滤。例如： + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +执行结果分别为： + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + + * SHOW LATEST TIMESERIES 表示查询出的时间序列需要按照最近插入时间戳降序排列 diff --git a/src/zh/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_timecho.md b/src/zh/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_timecho.md index 0fa4e4ecc..d8d79ebf6 100644 --- a/src/zh/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_timecho.md +++ b/src/zh/UserGuide/dev-1.3/Basic-Concept/Operate-Metadata_timecho.md @@ -140,9 +140,7 @@ It costs 0.002s ### 数据存活时间（TTL） -IoTDB 支持对 device 级别设置数据存活时间（TTL），这使得 IoTDB 可以定期、自动地删除一定时间之前的数据。合理使用 TTL -可以帮助您控制 IoTDB 占用的总磁盘空间以避免出现磁盘写满等异常。并且，随着文件数量的增多，查询性能往往随之下降， -内存占用也会有所提高。及时地删除一些较老的文件有助于使查询性能维持在一个较高的水平和减少内存资源的占用。 +IoTDB 支持对 device 级别设置数据存活时间（TTL），这使得 IoTDB 可以定期、自动地删除一定时间之前的数据。合理使用 TTL 可以帮助您控制 IoTDB 占用的总磁盘空间以避免出现磁盘写满等异常。并且，随着文件数量的增多，查询性能往往随之下降，内存占用也会有所提高。及时地删除一些较老的文件有助于使查询性能维持在一个较高的水平和减少内存资源的占用。 TTL的默认单位为毫秒，如果配置文件中的时间精度修改为其他单位，设置ttl时仍然使用毫秒单位。 @@ -725,6 +723,37 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + 对查询结果集根据标签进行过滤。例如： + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +执行结果分别为： + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + * SHOW LATEST TIMESERIES diff --git a/src/zh/UserGuide/latest/Basic-Concept/Operate-Metadata_apache.md b/src/zh/UserGuide/latest/Basic-Concept/Operate-Metadata_apache.md index da47fcf63..bfb0391fc 100644 --- a/src/zh/UserGuide/latest/Basic-Concept/Operate-Metadata_apache.md +++ b/src/zh/UserGuide/latest/Basic-Concept/Operate-Metadata_apache.md @@ -725,6 +725,37 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + 对查询结果集根据标签进行过滤。例如： + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +执行结果分别为： + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + * SHOW LATEST TIMESERIES 表示查询出的时间序列需要按照最近插入时间戳降序排列 @@ -984,7 +1015,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' ## 4. 路径查询 -### 路径（Path） +### 4.1 路径（Path） 路径（path）是用于表示时间序列的层级结构的表达式，其语法定义如下： ```SQL @@ -1002,7 +1033,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' | '**' ; ``` -### 路径结点名（NodeName） +### 4.2 路径结点名（NodeName） - 路径中由 `.` 分割的部分称为路径结点名（nodeName）。 - 例如，`root.a.b.c` 是一个层级为 4 的路径，其中 root、a、b 和 c 都是路径结点名。 @@ -1017,11 +1048,11 @@ IoTDB> show timeseries where TAGS(tag1)='v1' - UNICODE 中文字符（\u2E80 到 \u9FFF） - 大小写敏感性：在 Windows 系统上，数据库路径结点名是大小写不敏感的。例如，root.ln 和 root.LN 会被视为相同的路径。 -### 特殊字符（反引号） +### 4.3 特殊字符（反引号） 如果`路径结点名（NodeName）`中需要使用特殊字符（如空格、标点符号等），可以使用反引号（`）将结点名引用起来。更多关于反引号的使用方法，请参考[反引号](../SQL-Manual/Syntax-Rule.md#反引号)。 -### 路径模式（Path Pattern） +### 4.4 路径模式（Path Pattern） 为了使得在表达多个时间序列的时候更加方便快捷，IoTDB 为用户提供带通配符`*`或`**`的路径。通配符可以出现在路径中的任何层。 @@ -1034,7 +1065,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' **注意**：* 和 ** 不能放在路径的开头。 -### 查看路径的所有子路径 +### 4.5 查看路径的所有子路径 ``` SHOW CHILD PATHS pathPattern @@ -1070,7 +1101,7 @@ It costs 0.002s +---------------+ ``` -### 4.2 查看路径的下一级节点 +### 4.6 查看路径的下一级节点 ``` SHOW CHILD NODES pathPattern @@ -1101,7 +1132,7 @@ SHOW CHILD NODES pathPattern +------------+ ``` -### 4.3 统计节点数 +### 4.7 统计节点数 IoTDB 支持使用`COUNT NODES LEVEL=`来统计当前 Metadata 树下满足某路径模式的路径中指定层级的节点个数。这条语句可以用来统计带有特定采样点的设备数。例如： @@ -1151,7 +1182,7 @@ It costs 0.002s > 注意：时间序列的路径只是过滤条件，与 level 的定义无关。 -### 4.4 查看设备 +### 4.8 查看设备 * SHOW DEVICES pathPattern? (WITH DATABASE)? devicesWhereClause? limitClause? @@ -1263,7 +1294,7 @@ Total line number = 2 It costs 0.001s ``` -### 4.5 统计设备数量 +### 4.9 统计设备数量 * COUNT DEVICES \ diff --git a/src/zh/UserGuide/latest/Basic-Concept/Operate-Metadata_timecho.md b/src/zh/UserGuide/latest/Basic-Concept/Operate-Metadata_timecho.md index 70af84bfe..effb7c035 100644 --- a/src/zh/UserGuide/latest/Basic-Concept/Operate-Metadata_timecho.md +++ b/src/zh/UserGuide/latest/Basic-Concept/Operate-Metadata_timecho.md @@ -724,12 +724,44 @@ It costs 0.016s ``` +* SHOW TIMESERIES WHERE TAGS(KEY) = VALUE +* SHOW TIMESERIES WHERE TAGS(KEY) CONTAINS VALUE + + 对查询结果集根据标签进行过滤。例如： + +``` +show timeseries root.ln.** where TAGS(unit)='c' +show timeseries root.ln.** where TAGS(description) contains 'test1' +``` + +执行结果分别为： + +``` ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.hardware| null| root.ln| TEXT| PLAIN| SNAPPY|{"unit":"c"}| null| null| null| ++--------------------------+-----+-------------+--------+--------+-----------+------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.005s + ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +| timeseries|alias| database|dataType|encoding|compression| tags|attributes|deadband|deadband parameters| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +|root.ln.wf02.wt02.status| null| root.ln| BOOLEAN| PLAIN| SNAPPY|{"description":"test1"}| null| null| null| ++------------------------+-----+-------------+--------+--------+-----------+-----------------------+----------+--------+-------------------+ +Total line number = 1 +It costs 0.004s + +``` + * SHOW LATEST TIMESERIES 表示查询出的时间序列需要按照最近插入时间戳降序排列 + 需要注意的是，当查询路径不存在时，系统会返回 0 条时间序列。 ### 3.5 统计时间序列总数 @@ -1025,7 +1057,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' ## 4. 路径查询 -### 路径（Path） +### 4.1 路径（Path） 路径（path）是用于表示时间序列的层级结构的表达式，其语法定义如下： ```SQL @@ -1043,7 +1075,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' | '**' ; ``` -### 路径结点名（NodeName） +### 4.2 路径结点名（NodeName） - 路径中由 `.` 分割的部分称为路径结点名（nodeName）。 - 例如，`root.a.b.c` 是一个层级为 4 的路径，其中 root、a、b 和 c 都是路径结点名。 @@ -1058,11 +1090,11 @@ IoTDB> show timeseries where TAGS(tag1)='v1' - UNICODE 中文字符（\u2E80 到 \u9FFF） - 大小写敏感性：在 Windows 系统上，数据库路径结点名是大小写不敏感的。例如，root.ln 和 root.LN 会被视为相同的路径。 -### 特殊字符（反引号） +### 4.3 特殊字符（反引号） 如果`路径结点名（NodeName）`中需要使用特殊字符（如空格、标点符号等），可以使用反引号（`）将结点名引用起来。更多关于反引号的使用方法，请参考[反引号](../SQL-Manual/Syntax-Rule.md#反引号)。 -### 路径模式（Path Pattern） +### 4.4 路径模式（Path Pattern） 为了使得在表达多个时间序列的时候更加方便快捷，IoTDB 为用户提供带通配符`*`或`**`的路径。通配符可以出现在路径中的任何层。 @@ -1075,7 +1107,7 @@ IoTDB> show timeseries where TAGS(tag1)='v1' **注意**：* 和 ** 不能放在路径的开头。 -### 查看路径的所有子路径 +### 4.5 查看路径的所有子路径 ``` SHOW CHILD PATHS pathPattern @@ -1111,7 +1143,7 @@ It costs 0.002s +---------------+ ``` -### 4.2 查看路径的下一级节点 +### 4.6 查看路径的下一级节点 ``` SHOW CHILD NODES pathPattern @@ -1142,7 +1174,7 @@ SHOW CHILD NODES pathPattern +------------+ ``` -### 4.3 统计节点数 +### 4.7 统计节点数 IoTDB 支持使用`COUNT NODES LEVEL=`来统计当前 Metadata 树下满足某路径模式的路径中指定层级的节点个数。这条语句可以用来统计带有特定采样点的设备数。例如： @@ -1192,7 +1224,7 @@ It costs 0.002s > 注意：时间序列的路径只是过滤条件，与 level 的定义无关。 -### 4.4 查看设备 +### 4.8 查看设备 * SHOW DEVICES pathPattern? (WITH DATABASE)? devicesWhereClause? limitClause? @@ -1304,7 +1336,7 @@ Total line number = 2 It costs 0.001s ``` -### 4.5 统计设备数量 +### 4.9 统计设备数量 * COUNT DEVICES \ @@ -1349,7 +1381,7 @@ Total line number = 1 It costs 0.004s ``` -### 4.6 活跃设备查询 +### 4.10 活跃设备查询 和活跃时间序列一样，我们可以在查看和统计设备的基础上添加时间过滤条件来查询在某段时间内存在数据的活跃设备。这里活跃的定义与活跃时间序列相同，使用样例如下： ``` IoTDB> insert into root.sg.data(timestamp, s1,s2) values(15000, 1, 2);