| import{_ as s,c as e,b as a,o as i}from"./app-W3EENNaa.js";const l={};function t(o,n){return i(),e("div",null,n[0]||(n[0]=[a(`<h1 id="cluster-information-query-command" tabindex="-1"><a class="header-anchor" href="#cluster-information-query-command"><span>Cluster Information Query Command</span></a></h1><h2 id="show-variables" tabindex="-1"><a class="header-anchor" href="#show-variables"><span>Show Variables</span></a></h2><p>Currently, IoTDB supports showing key parameters of the cluster:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">SHOW VARIABLES</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><p>Eg:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show variables</span> |
| <span class="line">+----------------------------------+-----------------------------------------------------------------+</span> |
| <span class="line">| Variable| Value|</span> |
| <span class="line">+----------------------------------+-----------------------------------------------------------------+</span> |
| <span class="line">| ClusterName| defaultCluster|</span> |
| <span class="line">| DataReplicationFactor| 1|</span> |
| <span class="line">| SchemaReplicationFactor| 1|</span> |
| <span class="line">| DataRegionConsensusProtocolClass| org.apache.iotdb.consensus.iot.IoTConsensus|</span> |
| <span class="line">|SchemaRegionConsensusProtocolClass| org.apache.iotdb.consensus.ratis.RatisConsensus|</span> |
| <span class="line">| ConfigNodeConsensusProtocolClass| org.apache.iotdb.consensus.ratis.RatisConsensus|</span> |
| <span class="line">| TimePartitionInterval| 604800000|</span> |
| <span class="line">| DefaultTTL(ms)| 9223372036854775807|</span> |
| <span class="line">| ReadConsistencyLevel| strong|</span> |
| <span class="line">| SchemaRegionPerDataNode| 1.0|</span> |
| <span class="line">| DataRegionPerProcessor| 1.0|</span> |
| <span class="line">| LeastDataRegionGroupNum| 5|</span> |
| <span class="line">| SeriesSlotNum| 10000|</span> |
| <span class="line">| SeriesSlotExecutorClass|org.apache.iotdb.commons.partition.executor.hash.BKDRHashExecutor|</span> |
| <span class="line">| DiskSpaceWarningThreshold| 0.05|</span> |
| <span class="line">+----------------------------------+-----------------------------------------------------------------+</span> |
| <span class="line">Total line number = 15</span> |
| <span class="line">It costs 0.225s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p><strong>Notice:</strong> Ensure that all key parameters displayed in this SQL are consist on each node in the same cluster</p><h2 id="show-confignode-information" tabindex="-1"><a class="header-anchor" href="#show-confignode-information"><span>Show ConfigNode information</span></a></h2><p>Currently, IoTDB supports showing ConfigNode information by the following SQL:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">SHOW CONFIGNODES</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><p>Eg:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show confignodes</span> |
| <span class="line">+------+-------+---------------+------------+--------+</span> |
| <span class="line">|NodeID| Status|InternalAddress|InternalPort| Role|</span> |
| <span class="line">+------+-------+---------------+------------+--------+</span> |
| <span class="line">| 0|Running| 127.0.0.1| 10710| Leader|</span> |
| <span class="line">| 1|Running| 127.0.0.1| 10711|Follower|</span> |
| <span class="line">| 2|Running| 127.0.0.1| 10712|Follower|</span> |
| <span class="line">+------+-------+---------------+------------+--------+</span> |
| <span class="line">Total line number = 3</span> |
| <span class="line">It costs 0.030s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><h3 id="confignode-status-definition" tabindex="-1"><a class="header-anchor" href="#confignode-status-definition"><span>ConfigNode status definition</span></a></h3><p>The ConfigNode statuses are defined as follows:</p><ul><li><strong>Running</strong>: The ConfigNode is running properly.</li><li><strong>Unknown</strong>: The ConfigNode doesn't report heartbeat properly.</li></ul><h2 id="show-datanode-information" tabindex="-1"><a class="header-anchor" href="#show-datanode-information"><span>Show DataNode information</span></a></h2><p>Currently, IoTDB supports showing DataNode information by the following SQL:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">SHOW DATANODES</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><p>Eg:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> create timeseries root.sg.d1.s1 with datatype=BOOLEAN,encoding=PLAIN</span> |
| <span class="line">Msg: The statement is executed successfully.</span> |
| <span class="line">IoTDB> create timeseries root.sg.d2.s1 with datatype=BOOLEAN,encoding=PLAIN</span> |
| <span class="line">Msg: The statement is executed successfully.</span> |
| <span class="line">IoTDB> create timeseries root.ln.d1.s1 with datatype=BOOLEAN,encoding=PLAIN</span> |
| <span class="line">Msg: The statement is executed successfully.</span> |
| <span class="line">IoTDB> show datanodes</span> |
| <span class="line">+------+-------+----------+-------+-------------+---------------+</span> |
| <span class="line">|NodeID| Status|RpcAddress|RpcPort|DataRegionNum|SchemaRegionNum|</span> |
| <span class="line">+------+-------+----------+-------+-------------+---------------+</span> |
| <span class="line">| 1|Running| 127.0.0.1| 6667| 0| 1|</span> |
| <span class="line">| 2|Running| 127.0.0.1| 6668| 0| 1|</span> |
| <span class="line">+------+-------+----------+-------+-------------+---------------+</span> |
| <span class="line">Total line number = 2</span> |
| <span class="line">It costs 0.007s</span> |
| <span class="line"></span> |
| <span class="line">IoTDB> insert into root.ln.d1(timestamp,s1) values(1,true)</span> |
| <span class="line">Msg: The statement is executed successfully.</span> |
| <span class="line">IoTDB> show datanodes</span> |
| <span class="line">+------+-------+----------+-------+-------------+---------------+</span> |
| <span class="line">|NodeID| Status|RpcAddress|RpcPort|DataRegionNum|SchemaRegionNum|</span> |
| <span class="line">+------+-------+----------+-------+-------------+---------------+</span> |
| <span class="line">| 1|Running| 127.0.0.1| 6667| 1| 1|</span> |
| <span class="line">| 2|Running| 127.0.0.1| 6668| 0| 1|</span> |
| <span class="line">+------+-------+----------+-------+-------------+---------------+</span> |
| <span class="line">Total line number = 2</span> |
| <span class="line">It costs 0.006s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><h3 id="datanode-status-definition" tabindex="-1"><a class="header-anchor" href="#datanode-status-definition"><span>DataNode status definition</span></a></h3><p>The state machine of DataNode is shown in the figure below:<br><img style="width:100%;max-width:500px;max-height:500px;margin-left:auto;margin-right:auto;display:block;" src="https://alioss.timecho.com/docs/img/UserGuide/Cluster/DataNode-StateMachine-EN.jpg?raw=true"></p><p>The DataNode statuses are defined as follows:</p><ul><li><strong>Running</strong>: The DataNode is running properly and is readable and writable.</li><li><strong>Unknown</strong>: The DataNode doesn't report heartbeat properly, the ConfigNode considers the DataNode as unreadable and un-writable.</li><li><strong>Removing</strong>: The DataNode is being removed from the cluster and is unreadable and un-writable.</li><li><strong>ReadOnly</strong>: The remaining disk space of DataNode is lower than disk_warning_threshold(default is 5%), the DataNode is readable but un-writable and cannot synchronize data.</li></ul><h2 id="show-all-node-information" tabindex="-1"><a class="header-anchor" href="#show-all-node-information"><span>Show all Node information</span></a></h2><p>Currently, IoTDB supports show the information of all Nodes by the following SQL:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">SHOW CLUSTER</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><p>Eg:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show cluster</span> |
| <span class="line">+------+----------+-------+---------------+------------+</span> |
| <span class="line">|NodeID| NodeType| Status|InternalAddress|InternalPort|</span> |
| <span class="line">+------+----------+-------+---------------+------------+</span> |
| <span class="line">| 0|ConfigNode|Running| 127.0.0.1| 10710|</span> |
| <span class="line">| 1|ConfigNode|Running| 127.0.0.1| 10711|</span> |
| <span class="line">| 2|ConfigNode|Running| 127.0.0.1| 10712|</span> |
| <span class="line">| 3| DataNode|Running| 127.0.0.1| 10730|</span> |
| <span class="line">| 4| DataNode|Running| 127.0.0.1| 10731|</span> |
| <span class="line">| 5| DataNode|Running| 127.0.0.1| 10732|</span> |
| <span class="line">+------+----------+-------+---------------+------------+</span> |
| <span class="line">Total line number = 6</span> |
| <span class="line">It costs 0.011s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>After a node is stopped, its status will change, as shown below:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show cluster</span> |
| <span class="line">+------+----------+-------+---------------+------------+</span> |
| <span class="line">|NodeID| NodeType| Status|InternalAddress|InternalPort|</span> |
| <span class="line">+------+----------+-------+---------------+------------+</span> |
| <span class="line">| 0|ConfigNode|Running| 127.0.0.1| 10710|</span> |
| <span class="line">| 1|ConfigNode|Unknown| 127.0.0.1| 10711|</span> |
| <span class="line">| 2|ConfigNode|Running| 127.0.0.1| 10712|</span> |
| <span class="line">| 3| DataNode|Running| 127.0.0.1| 10730|</span> |
| <span class="line">| 4| DataNode|Running| 127.0.0.1| 10731|</span> |
| <span class="line">| 5| DataNode|Running| 127.0.0.1| 10732|</span> |
| <span class="line">+------+----------+-------+---------------+------------+</span> |
| <span class="line">Total line number = 6</span> |
| <span class="line">It costs 0.012s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>Show the details of all nodes:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">SHOW CLUSTER DETAILS</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div></div></div><p>Eg:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show cluster details</span> |
| <span class="line">+------+----------+-------+---------------+------------+-------------------+----------+-------+-------+-------------------+-----------------+</span> |
| <span class="line">|NodeID| NodeType| Status|InternalAddress|InternalPort|ConfigConsensusPort|RpcAddress|RpcPort|MppPort|SchemaConsensusPort|DataConsensusPort|</span> |
| <span class="line">+------+----------+-------+---------------+------------+-------------------+----------+-------+-------+-------------------+-----------------+</span> |
| <span class="line">| 0|ConfigNode|Running| 127.0.0.1| 10710| 10720| | | | | |</span> |
| <span class="line">| 1|ConfigNode|Running| 127.0.0.1| 10711| 10721| | | | | |</span> |
| <span class="line">| 2|ConfigNode|Running| 127.0.0.1| 10712| 10722| | | | | |</span> |
| <span class="line">| 3| DataNode|Running| 127.0.0.1| 10730| | 127.0.0.1| 6667| 10740| 10750| 10760|</span> |
| <span class="line">| 4| DataNode|Running| 127.0.0.1| 10731| | 127.0.0.1| 6668| 10741| 10751| 10761|</span> |
| <span class="line">| 5| DataNode|Running| 127.0.0.1| 10732| | 127.0.0.1| 6669| 10742| 10752| 10762|</span> |
| <span class="line">+------+----------+-------+---------------+------------+-------------------+----------+-------+-------+-------------------+-----------------+</span> |
| <span class="line">Total line number = 6</span> |
| <span class="line">It costs 0.340s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><h2 id="show-region-information" tabindex="-1"><a class="header-anchor" href="#show-region-information"><span>Show Region information</span></a></h2><p>The cluster uses a SchemaRegion/DataRegion as a unit for schema/data replication and data management.<br> The Region status and distribution is helpful for system operation and maintenance testing, as shown in the following scenarios:</p><ul><li>Check which DataNodes are allocated to each Region in the cluster and whether they are balanced.</li><li>Check the partitions allocated to each Region in the cluster and whether they are balanced.</li><li>Check which DataNodes are allocated by the leaders of each RegionGroup in the cluster and whether they are balanced.</li></ul><p>Currently, IoTDB supports show Region information by the following SQL:</p><ul><li><code>SHOW REGIONS</code>: Show distribution of all Regions.</li><li><code>SHOW SCHEMA REGIONS</code>: Show distribution of all SchemaRegions.</li><li><code>SHOW DATA REGIONS</code>: Show distribution of all DataRegions.</li><li><code>SHOW (DATA|SCHEMA)? REGIONS OF DATABASE <sg1,sg2,...></code>: Show Region distribution of specified StorageGroups.</li></ul><p>Show distribution of all Regions:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show regions</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">|RegionId| Type| Status|Database|SeriesSlots|TimeSlots|DataNodeId|RpcAddress|RpcPort| Role|</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 2| 127.0.0.1| 6668| Leader|</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 2| 127.0.0.1| 6668|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 3| 127.0.0.1| 6669| Leader|</span> |
| <span class="line">| 2| DataRegion|Running|root.sg2| 1| 1| 1| 127.0.0.1| 6667| Leader|</span> |
| <span class="line">| 2| DataRegion|Running|root.sg2| 1| 1| 2| 127.0.0.1| 6668|Follower|</span> |
| <span class="line">| 2| DataRegion|Running|root.sg2| 1| 1| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 2| 127.0.0.1| 6668| Leader|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">Total line number = 12</span> |
| <span class="line">It costs 0.165s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>Show the distribution of SchemaRegions or DataRegions:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show data regions</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">|RegionId| Type| Status|Database|SeriesSlots|TimeSlots|DataNodeId|RpcAddress|RpcPort| Role|</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 2| 127.0.0.1| 6668| Leader|</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">| 2| DataRegion|Running|root.sg2| 1| 1| 1| 127.0.0.1| 6667| Leader|</span> |
| <span class="line">| 2| DataRegion|Running|root.sg2| 1| 1| 2| 127.0.0.1| 6668|Follower|</span> |
| <span class="line">| 2| DataRegion|Running|root.sg2| 1| 1| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">Total line number = 6</span> |
| <span class="line">It costs 0.011s</span> |
| <span class="line"></span> |
| <span class="line">IoTDB> show schema regions</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">|RegionId| Type| Status|Database|SeriesSlots|TimeSlots|DataNodeId|RpcAddress|RpcPort| Role|</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 2| 127.0.0.1| 6668|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 3| 127.0.0.1| 6669| Leader|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 2| 127.0.0.1| 6668| Leader|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">Total line number = 6</span> |
| <span class="line">It costs 0.012s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><p>Show Region distribution of specified StorageGroups:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show regions of database root.sg1</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">|RegionId| Type| Status|Database|SeriesSlots|TimeSlots|DataNodeId|RpcAddress|RpcPort| Role|</span> |
| <span class="line">+--------+------------+-------+-- -----+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 2| 127.0.0.1| 6668| Leader|</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 2| 127.0.0.1| 6668|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 3| 127.0.0.1| 6669| Leader|</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">Total line number = 6</span> |
| <span class="line">It costs 0.007s</span> |
| <span class="line"></span> |
| <span class="line">IoTDB> show regions of database root.sg1, root.sg2</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">|RegionId| Type| Status|Database|SeriesSlots|TimeSlots|DataNodeId|RpcAddress|RpcPort| Role|</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 2| 127.0.0.1| 6668| Leader|</span> |
| <span class="line">| 0| DataRegion|Running|root.sg1| 1| 1| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 2| 127.0.0.1| 6668|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 3| 127.0.0.1| 6669| Leader|</span> |
| <span class="line">| 2| DataRegion|Running|root.sg2| 1| 1| 1| 127.0.0.1| 6667| Leader|</span> |
| <span class="line">| 2| DataRegion|Running|root.sg2| 1| 1| 2| 127.0.0.1| 6668|Follower|</span> |
| <span class="line">| 2| DataRegion|Running|root.sg2| 1| 1| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 2| 127.0.0.1| 6668| Leader|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">Total line number = 12</span> |
| <span class="line">It costs 0.009s</span> |
| <span class="line"></span> |
| <span class="line">IoTDB> show data regions of database root.sg1, root.sg2</span> |
| <span class="line">+--------+----------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">|RegionId| Type| Status|Database|SeriesSlots|TimeSlots|DataNodeId|RpcAddress|RpcPort| Role|</span> |
| <span class="line">+--------+----------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">| 0|DataRegion|Running|root.sg1| 1| 1| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 0|DataRegion|Running|root.sg1| 1| 1| 2| 127.0.0.1| 6668| Leader|</span> |
| <span class="line">| 0|DataRegion|Running|root.sg1| 1| 1| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">| 2|DataRegion|Running|root.sg2| 1| 1| 1| 127.0.0.1| 6667| Leader|</span> |
| <span class="line">| 2|DataRegion|Running|root.sg2| 1| 1| 2| 127.0.0.1| 6668|Follower|</span> |
| <span class="line">| 2|DataRegion|Running|root.sg2| 1| 1| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">+--------+----------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">Total line number = 6</span> |
| <span class="line">It costs 0.007s</span> |
| <span class="line"></span> |
| <span class="line">IoTDB> show schema regions of database root.sg1, root.sg2</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">|RegionId| Type| Status|Database|SeriesSlots|TimeSlots|DataNodeId|RpcAddress|RpcPort| Role|</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 2| 127.0.0.1| 6668|Follower|</span> |
| <span class="line">| 1|SchemaRegion|Running|root.sg1| 1| 0| 3| 127.0.0.1| 6669| Leader|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 1| 127.0.0.1| 6667|Follower|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 2| 127.0.0.1| 6668| Leader|</span> |
| <span class="line">| 3|SchemaRegion|Running|root.sg2| 1| 0| 3| 127.0.0.1| 6669|Follower|</span> |
| <span class="line">+--------+------------+-------+--------+-----------+---------+----------+----------+-------+--------+</span> |
| <span class="line">Total line number = 6</span> |
| <span class="line">It costs 0.009s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><h3 id="region-status-definition" tabindex="-1"><a class="header-anchor" href="#region-status-definition"><span>Region status definition</span></a></h3><p>Region inherits the status of the DataNode where the Region resides. And Region states are defined as follows:</p><ul><li><strong>Running</strong>: The DataNode where the Region resides is running properly, the Region is readable and writable.</li><li><strong>Unknown</strong>: The DataNode where the Region resides doesn't report heartbeat properly, the ConfigNode considers the Region is unreadable and un-writable.</li><li><strong>Removing</strong>: The DataNode where the Region resides is being removed from the cluster, the Region is unreadable and un-writable.</li><li><strong>ReadOnly</strong>: The available disk space of the DataNode where the Region resides is lower than the disk_warning_threshold(5% by default). The Region is readable but un-writable and cannot synchronize data.</li></ul><h2 id="show-cluster-slots-information" tabindex="-1"><a class="header-anchor" href="#show-cluster-slots-information"><span>Show cluster slots information</span></a></h2><p>The cluster uses partitions for schema and data arrangement, the partition is defined as follows:</p><ul><li><code>SchemaPartition</code>: series slot</li><li><code>DataPartition</code>: <series slot, time slot></li></ul><p>The cluster slots information can be shown by the following SQLs:</p><h3 id="show-the-dataregion-where-a-datapartition-resides" tabindex="-1"><a class="header-anchor" href="#show-the-dataregion-where-a-datapartition-resides"><span>Show the DataRegion where a DataPartition resides</span></a></h3><p>Show the DataRegion where a DataPartition(or all DataPartitions under a same series slot) resides:</p><ul><li><code>SHOW DATA REGIONID OF root.sg WHERE SERIESSLOTID=s0 (AND TIMESLOTID=t0)</code></li></ul><p>Eg:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show data regionid of root.sg where seriesslotid=5286 and timeslotid=0</span> |
| <span class="line">+--------+</span> |
| <span class="line">|RegionId|</span> |
| <span class="line">+--------+</span> |
| <span class="line">| 1|</span> |
| <span class="line">+--------+</span> |
| <span class="line">Total line number = 1</span> |
| <span class="line">It costs 0.006s</span> |
| <span class="line"></span> |
| <span class="line">IoTDB> show data regionid of root.sg where seriesslotid=5286</span> |
| <span class="line">+--------+</span> |
| <span class="line">|RegionId|</span> |
| <span class="line">+--------+</span> |
| <span class="line">| 1|</span> |
| <span class="line">| 2|</span> |
| <span class="line">+--------+</span> |
| <span class="line">Total line number = 2</span> |
| <span class="line">It costs 0.006s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><h3 id="show-the-schemaregion-where-a-schemapartition-resides" tabindex="-1"><a class="header-anchor" href="#show-the-schemaregion-where-a-schemapartition-resides"><span>Show the SchemaRegion where a SchemaPartition resides</span></a></h3><p>Show the SchemaRegion where a SchemaPartition resides:</p><ul><li><code>SHOW SCHEMA REGIONID OF root.sg WHERE SERIESSLOTID=s0</code></li></ul><p>Eg:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show schema regionid of root.sg where seriesslotid=5286</span> |
| <span class="line">+--------+</span> |
| <span class="line">|RegionId|</span> |
| <span class="line">+--------+</span> |
| <span class="line">| 0|</span> |
| <span class="line">+--------+</span> |
| <span class="line">Total line number = 1</span> |
| <span class="line">It costs 0.007s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><h3 id="show-time-slots-of-a-series-slot" tabindex="-1"><a class="header-anchor" href="#show-time-slots-of-a-series-slot"><span>Show time slots of a series slot</span></a></h3><p>Show the time slots under a particular series slot.</p><ul><li><code>SHOW TIMESLOTID OF root.sg WHERE SERIESLOTID=s0 (AND STARTTIME=t1) (AND ENDTIME=t2)</code></li></ul><p>Eg:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show timeslotid of root.sg where seriesslotid=5286</span> |
| <span class="line">+----------+</span> |
| <span class="line">|TimeSlotId|</span> |
| <span class="line">+----------+</span> |
| <span class="line">| 0|</span> |
| <span class="line">| 1000|</span> |
| <span class="line">+----------+</span> |
| <span class="line">Total line number = 1</span> |
| <span class="line">It costs 0.007s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div><h3 id="show-database-s-series-slots" tabindex="-1"><a class="header-anchor" href="#show-database-s-series-slots"><span>Show Database's series slots</span></a></h3><p>Show the data/schema/all series slots related to a database:</p><ul><li><code>SHOW (DATA|SCHEMA)? SERIESSLOTID OF root.sg</code></li></ul><p>Eg:</p><div class="language-text line-numbers-mode" data-highlighter="prismjs" data-ext="text" data-title="text"><pre><code><span class="line">IoTDB> show data seriesslotid of root.sg</span> |
| <span class="line">+------------+</span> |
| <span class="line">|SeriesSlotId|</span> |
| <span class="line">+------------+</span> |
| <span class="line">| 5286|</span> |
| <span class="line">+------------+</span> |
| <span class="line">Total line number = 1</span> |
| <span class="line">It costs 0.007s</span> |
| <span class="line"></span> |
| <span class="line">IoTDB> show schema seriesslotid of root.sg</span> |
| <span class="line">+------------+</span> |
| <span class="line">|SeriesSlotId|</span> |
| <span class="line">+------------+</span> |
| <span class="line">| 5286|</span> |
| <span class="line">+------------+</span> |
| <span class="line">Total line number = 1</span> |
| <span class="line">It costs 0.006s</span> |
| <span class="line"></span> |
| <span class="line">IoTDB> show seriesslotid of root.sg</span> |
| <span class="line">+------------+</span> |
| <span class="line">|SeriesSlotId|</span> |
| <span class="line">+------------+</span> |
| <span class="line">| 5286|</span> |
| <span class="line">+------------+</span> |
| <span class="line">Total line number = 1</span> |
| <span class="line">It costs 0.006s</span> |
| <span class="line"></span></code></pre><div class="line-numbers" aria-hidden="true" style="counter-reset:line-number 0;"><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div><div class="line-number"></div></div></div>`,73)]))}const r=s(l,[["render",t],["__file","Cluster-Maintenance.html.vue"]]),c=JSON.parse(`{"path":"/UserGuide/V1.0.x/Cluster/Cluster-Maintenance.html","title":"Cluster Information Query Command","lang":"en-US","frontmatter":{"description":"Cluster Information Query Command Show Variables Currently, IoTDB supports showing key parameters of the cluster: Eg: Notice: Ensure that all key parameters displayed in this SQ...","head":[["link",{"rel":"alternate","hreflang":"zh-cn","href":"https://iotdb.apache.org/zh/UserGuide/V1.0.x/Cluster/Cluster-Maintenance.html"}],["meta",{"property":"og:url","content":"https://iotdb.apache.org/UserGuide/V1.0.x/Cluster/Cluster-Maintenance.html"}],["meta",{"property":"og:site_name","content":"IoTDB Website"}],["meta",{"property":"og:title","content":"Cluster Information Query Command"}],["meta",{"property":"og:description","content":"Cluster Information Query Command Show Variables Currently, IoTDB supports showing key parameters of the cluster: Eg: Notice: Ensure that all key parameters displayed in this SQ..."}],["meta",{"property":"og:type","content":"article"}],["meta",{"property":"og:locale","content":"en-US"}],["meta",{"property":"og:locale:alternate","content":"zh-CN"}],["meta",{"property":"og:updated_time","content":"2023-07-10T03:11:17.000Z"}],["meta",{"property":"article:modified_time","content":"2023-07-10T03:11:17.000Z"}],["script",{"type":"application/ld+json"},"{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"Article\\",\\"headline\\":\\"Cluster Information Query Command\\",\\"image\\":[\\"\\"],\\"dateModified\\":\\"2023-07-10T03:11:17.000Z\\",\\"author\\":[]}"]]},"headers":[{"level":2,"title":"Show Variables","slug":"show-variables","link":"#show-variables","children":[]},{"level":2,"title":"Show ConfigNode information","slug":"show-confignode-information","link":"#show-confignode-information","children":[{"level":3,"title":"ConfigNode status definition","slug":"confignode-status-definition","link":"#confignode-status-definition","children":[]}]},{"level":2,"title":"Show DataNode information","slug":"show-datanode-information","link":"#show-datanode-information","children":[{"level":3,"title":"DataNode status definition","slug":"datanode-status-definition","link":"#datanode-status-definition","children":[]}]},{"level":2,"title":"Show all Node information","slug":"show-all-node-information","link":"#show-all-node-information","children":[]},{"level":2,"title":"Show Region information","slug":"show-region-information","link":"#show-region-information","children":[{"level":3,"title":"Region status definition","slug":"region-status-definition","link":"#region-status-definition","children":[]}]},{"level":2,"title":"Show cluster slots information","slug":"show-cluster-slots-information","link":"#show-cluster-slots-information","children":[{"level":3,"title":"Show the DataRegion where a DataPartition resides","slug":"show-the-dataregion-where-a-datapartition-resides","link":"#show-the-dataregion-where-a-datapartition-resides","children":[]},{"level":3,"title":"Show the SchemaRegion where a SchemaPartition resides","slug":"show-the-schemaregion-where-a-schemapartition-resides","link":"#show-the-schemaregion-where-a-schemapartition-resides","children":[]},{"level":3,"title":"Show time slots of a series slot","slug":"show-time-slots-of-a-series-slot","link":"#show-time-slots-of-a-series-slot","children":[]},{"level":3,"title":"Show Database's series slots","slug":"show-database-s-series-slots","link":"#show-database-s-series-slots","children":[]}]}],"git":{"createdTime":1688958677000,"updatedTime":1688958677000,"contributors":[{"name":"CritasWang","email":"critas@outlook.com","commits":1}]},"readingTime":{"minutes":6.47,"words":1941},"filePathRelative":"UserGuide/V1.0.x/Cluster/Cluster-Maintenance.md","localizedDate":"July 10, 2023","autoDesc":true}`);export{r as comp,c as data}; |