Skip to main content

Node Management

About 2 min

Node Management

Show Child Paths

SHOW CHILD PATHS pathPattern ? limitClause

Return all child paths of all the paths matching pathPattern.

The default size of result set is 10000000. To query more child paths, please use limit and offset.

Example:

  • return the child paths of root.ln:show child paths root.ln
+------------+
| child paths|
+------------+
|root.ln.wf01|
|root.ln.wf02|
+------------+
Total line number = 2
It costs 0.002s

get all paths in form of root.xx.xx.xx:show child paths root.xx.xx

Show Child Nodes

SHOW CHILD NODES pathPattern ? limitClause

Return all child nodes of the pathPattern.

The default size of result set is 10000000. To query more child paths, please use limit and offset.

Example:

  • return the child nodes of root:show child nodes root
+------------+
| child nodes|
+------------+
|          ln|
+------------+
  • return the child nodes of root.ln:show child nodes root.ln
+------------+
| child nodes|
+------------+
|        wf01|
|        wf02|
+------------+

Count Nodes

IoTDB is able to use COUNT NODES <PathPattern> LEVEL=<INTEGER> to count the number of nodes at
the given level in current Metadata Tree considering a given pattern. IoTDB will find paths that
match the pattern and counts distinct nodes at the specified level among the matched paths.
This could be used to query the number of devices with specified measurements. The usage are as
follows:

IoTDB > COUNT NODES root.** LEVEL=2
IoTDB > COUNT NODES root.ln.** LEVEL=2
IoTDB > COUNT NODES root.ln.wf01.** LEVEL=3
IoTDB > COUNT NODES root.**.temperature LEVEL=3

As for the above mentioned example and Metadata tree, you can get following results:

+-----+
|count|
+-----+
|    4|
+-----+
Total line number = 1
It costs 0.003s

+-----+
|count|
+-----+
|    2|
+-----+
Total line number = 1
It costs 0.002s

+-----+
|count|
+-----+
|    1|
+-----+
Total line number = 1
It costs 0.002s

+-----+
|count|
+-----+
|    2|
+-----+
Total line number = 1
It costs 0.002s

Note: The path of timeseries is just a filter condition, which has no relationship with the definition of level.

Show Devices

  • SHOW DEVICES pathPattern? (WITH STORAGE GROUP)? limitClause? #showDevices

The default size of result set is 10000000. To query more child paths, please use limit and offset.

Similar to Show Timeseries, IoTDB also supports two ways of viewing devices:

  • SHOW DEVICES statement presents all devices' information, which is equal to SHOW DEVICES root.**.
  • SHOW DEVICES <PathPattern> statement specifies the PathPattern and returns the devices information matching the pathPattern and under the given level.

SQL statement is as follows:

IoTDB> show devices
IoTDB> show devices root.ln.**

You can get results below:

+-------------------+---------+
|            devices|isAligned|
+-------------------+---------+
|  root.ln.wf01.wt01|    false|
|  root.ln.wf02.wt02|    false|
|root.sgcc.wf03.wt01|    false|
|    root.turbine.d1|    false|
+-------------------+---------+
Total line number = 4
It costs 0.002s

+-----------------+---------+
|          devices|isAligned|
+-----------------+---------+
|root.ln.wf01.wt01|    false|
|root.ln.wf02.wt02|    false|
+-----------------+---------+
Total line number = 2
It costs 0.001s

isAligned indicates whether the timeseries under the device are aligned.

To view devices' information with storage group, we can use SHOW DEVICES WITH STORAGE GROUP statement.

  • SHOW DEVICES WITH STORAGE GROUP statement presents all devices' information with their storage group.
  • SHOW DEVICES <PathPattern> WITH STORAGE GROUP statement specifies the PathPattern and returns the
    devices' information under the given level with their storage group information.

SQL statement is as follows:

IoTDB> show devices with storage group
IoTDB> show devices root.ln.** with storage group

You can get results below:

+-------------------+-------------+---------+
|            devices|storage group|isAligned|
+-------------------+-------------+---------+
|  root.ln.wf01.wt01|      root.ln|    false|
|  root.ln.wf02.wt02|      root.ln|    false|
|root.sgcc.wf03.wt01|    root.sgcc|    false|
|    root.turbine.d1| root.turbine|    false|
+-------------------+-------------+---------+
Total line number = 4
It costs 0.003s

+-----------------+-------------+---------+
|          devices|storage group|isAligned|
+-----------------+-------------+---------+
|root.ln.wf01.wt01|      root.ln|    false|
|root.ln.wf02.wt02|      root.ln|    false|
+-----------------+-------------+---------+
Total line number = 2
It costs 0.001s

Copyright © 2024 The Apache Software Foundation.
Apache and the Apache feather logo are trademarks of The Apache Software Foundation

Have a question? Connect with us on QQ, WeChat, or Slack. Join the community now.

We use Google Analytics to collect anonymous, aggregated usage information.