路径结点名

路径结点名是特殊的标识符，其还可以是通配符 * 或 **。在创建时间序列时，各层级的路径结点名不能为通配符 * 或 **。在查询语句中，可以用通配符 * 或 ** 来表示路径结点名，以匹配一层或多层路径。

通配符

*在路径中表示一层。例如root.vehicle.*.sensor1代表的是以root.vehicle为前缀，以sensor1为后缀，层次等于 4 层的路径。

**在路径中表示是（*）+，即为一层或多层*。例如root.vehicle.device1.**代表的是root.vehicle.device1.*, root.vehicle.device1.*.*, root.vehicle.device1.*.*.*等所有以root.vehicle.device1为前缀路径的大于等于 4 层的路径；root.vehicle.**.sensor1代表的是以root.vehicle为前缀，以sensor1为后缀，层次大于等于 4 层的路径。

由于通配符 * 在查询表达式中也可以表示乘法符号，下述例子用于帮助您区分两种情况：

  1. # 创建时间序列 root.sg.`a*b`
  2. create timeseries root.sg.`a*b` with datatype=FLOAT,encoding=PLAIN;
  3. # 请注意，如标识符部分所述，a*b包含特殊字符，需要用``括起来使用
  4. # create timeseries root.sg.a*b with datatype=FLOAT,encoding=PLAIN 是错误用法
  6. # 创建时间序列 root.sg.a
  7. create timeseries root.sg.a with datatype=FLOAT,encoding=PLAIN;
  9. # 创建时间序列 root.sg.b
  10. create timeseries root.sg.b with datatype=FLOAT,encoding=PLAIN;
  12. # 查询时间序列 root.sg.`a*b`
  13. select `a*b` from root.sg
  14. # 其结果集表头为
  15. |Time|root.sg.a*b|
  17. # 查询时间序列 root.sg.a 和 root.sg.b的乘积
  18. select a*b from root.sg
  19. # 其结果集表头为
  20. |Time|root.sg.a * root.sg.b|

标识符

路径结点名不为通配符时，使用方法和标识符一致。在 SQL 中需要使用反引号引用的路径结点，在结果集中也会用反引号引起。

需要使用反引号进行引用的部分特殊情况示例：

  • 创建时间序列时，如下情况需要使用反引号对特殊节点名进行引用：
  1. # 路径结点名中包含特殊字符，时间序列各结点为["root","sg","www.`baidu.com"]
  2. create timeseries root.sg.`www.baidu.com`.a with datatype=FLOAT,encoding=PLAIN;
  4. # 路径结点名为实数
  5. create timeseries root.sg.`111` with datatype=FLOAT,encoding=PLAIN;

依次执行示例中语句后，执行 show timeseries，结果如下：

  1. +---------------------------+-----+-------------+--------+--------+-----------+----+----------+
  2. |                 timeseries|alias|database|dataType|encoding|compression|tags|attributes|
  3. +---------------------------+-----+-------------+--------+--------+-----------+----+----------+
  4. |            root.sg.`111`.a| null|      root.sg|   FLOAT|   PLAIN|     SNAPPY|null|      null|
  5. |root.sg.`www.baidu.com`.a| null|      root.sg|   FLOAT|   PLAIN|     SNAPPY|null|      null|
  6. +---------------------------+-----+-------------+--------+--------+-----------+----+----------+
  • 插入数据时，如下情况需要使用反引号对特殊节点名进行引用：
  1. # 路径结点名中包含特殊字符
  2. insert into root.sg.`www.baidu.com`(timestamp, a) values(1, 2);
  4. # 路径结点名为实数
  5. insert into root.sg(timestamp, `111`) values (1, 2);
  • 查询数据时，如下情况需要使用反引号对特殊节点名进行引用：
  1. # 路径结点名中包含特殊字符
  2. select a from root.sg.`www.baidu.com`;
  4. # 路径结点名为实数
  5. select `111` from root.sg

结果集分别为：

  1. # select a from root.sg.`www.baidu.com` 结果集
  2. +-----------------------------+---------------------------+
  3. |                         Time|root.sg.`www.baidu.com`.a|
  4. +-----------------------------+---------------------------+
  5. |1970-01-01T08:00:00.001+08:00|                        2.0|
  6. +-----------------------------+---------------------------+
  8. # select `111` from root.sg 结果集
  9. +-----------------------------+-------------+
  10. |                         Time|root.sg.`111`|
  11. +-----------------------------+-------------+
  12. |1970-01-01T08:00:00.001+08:00|          2.0|
  13. +-----------------------------+-------------+