This is an automated email from the ASF dual-hosted git repository.
critas pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/iotdb-docs.git
The following commit(s) were added to refs/heads/main by this push:
new 7ea1bd67 add show available urls to maintenance statements from 208
(#973)
7ea1bd67 is described below
commit 7ea1bd6793e4e695aef8639bb924ffe196db714c
Author: leto-b <[email protected]>
AuthorDate: Wed Feb 4 11:59:28 2026 +0800
add show available urls to maintenance statements from 208 (#973)
---
.../Table/SQL-Manual/SQL-Maintenance-Statements.md | 32 +++++++++++++++++++++-
.../User-Manual/Maintenance-commands_apache.md | 30 ++++++++++++++++++++
.../User-Manual/Maintenance-commands_timecho.md | 30 ++++++++++++++++++++
.../Tree/User-Manual/Maintenance-commands.md | 31 ++++++++++++++++++++-
.../SQL-Manual/SQL-Maintenance-Statements.md | 32 +++++++++++++++++++++-
.../User-Manual/Maintenance-commands_apache.md | 30 ++++++++++++++++++++
.../User-Manual/Maintenance-commands_timecho.md | 30 ++++++++++++++++++++
.../latest/User-Manual/Maintenance-commands.md | 30 ++++++++++++++++++++
.../Table/SQL-Manual/SQL-Maintenance-Statements.md | 31 ++++++++++++++++++++-
.../User-Manual/Maintenance-statement_apache.md | 30 ++++++++++++++++++++
.../User-Manual/Maintenance-statement_timecho.md | 30 ++++++++++++++++++++
.../Tree/User-Manual/Maintenance-statement.md | 31 +++++++++++++++++++++
.../SQL-Manual/SQL-Maintenance-Statements.md | 30 ++++++++++++++++++++
.../User-Manual/Maintenance-statement_apache.md | 30 ++++++++++++++++++++
.../User-Manual/Maintenance-statement_timecho.md | 30 ++++++++++++++++++++
.../latest/User-Manual/Maintenance-statement.md | 30 ++++++++++++++++++++
16 files changed, 483 insertions(+), 4 deletions(-)
diff --git
a/src/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements.md
b/src/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements.md
index 1a72ce7f..0500f17f 100644
--- a/src/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements.md
+++ b/src/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements.md
@@ -195,7 +195,7 @@ IoTDB> SHOW CURRENT_TIMESTAMP
```
-### 1.8 Viewing Region Information
+### 1.8 View Region Information
**Description**: Displays regions' information of the current cluster.
@@ -225,6 +225,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.9 View Available Nodes
+
+**Description**: Returns the RPC addresses and ports of all available
DataNodes in the current cluster. Note: A DataNode is considered "available" if
it is not in the REMOVING state.
+
+> This feature is supported starting from v2.0.8.
+
+**Syntax**:
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+**Result**:
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. Status Configuration
diff --git
a/src/UserGuide/Master/Table/User-Manual/Maintenance-commands_apache.md
b/src/UserGuide/Master/Table/User-Manual/Maintenance-commands_apache.md
index e2be89e6..659e7a5d 100644
--- a/src/UserGuide/Master/Table/User-Manual/Maintenance-commands_apache.md
+++ b/src/UserGuide/Master/Table/User-Manual/Maintenance-commands_apache.md
@@ -337,6 +337,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.10 Viewing Available Nodes
+
+**Description**: Returns the RPC addresses and ports of all available
DataNodes in the current cluster. Note: A DataNode is considered "available" if
it is not in the REMOVING state.
+
+> This feature is supported starting from v2.0.8.
+
+**Syntax**:
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+**Result**:
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. Status Setting
diff --git
a/src/UserGuide/Master/Table/User-Manual/Maintenance-commands_timecho.md
b/src/UserGuide/Master/Table/User-Manual/Maintenance-commands_timecho.md
index c4c4feec..02185325 100644
--- a/src/UserGuide/Master/Table/User-Manual/Maintenance-commands_timecho.md
+++ b/src/UserGuide/Master/Table/User-Manual/Maintenance-commands_timecho.md
@@ -337,6 +337,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.10 Viewing Available Nodes
+
+**Description**: Returns the RPC addresses and ports of all available
DataNodes in the current cluster. Note: A DataNode is considered "available" if
it is not in the REMOVING state.
+
+> This feature is supported starting from v2.0.8.
+
+**Syntax**:
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+**Result**:
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. Status Setting
diff --git a/src/UserGuide/Master/Tree/User-Manual/Maintenance-commands.md
b/src/UserGuide/Master/Tree/User-Manual/Maintenance-commands.md
index 27a286b5..b6d0988b 100644
--- a/src/UserGuide/Master/Tree/User-Manual/Maintenance-commands.md
+++ b/src/UserGuide/Master/Tree/User-Manual/Maintenance-commands.md
@@ -212,7 +212,6 @@ IoTDB> SHOW QUERIES WHERE elapsedtime > 0.003
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+
```
-
### 1.6 Viewing Region Information
**Description**: Displays regions' information of the current cluster.
@@ -244,6 +243,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.7 Viewing Available Nodes
+
+**Description**: Returns the RPC addresses and ports of all available
DataNodes in the current cluster. Note: A DataNode is considered "available" if
it is not in the REMOVING state.
+
+> This feature is supported starting from v2.0.8.
+
+**Syntax**:
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+**Result**:
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. Status Setting
diff --git
a/src/UserGuide/latest-Table/SQL-Manual/SQL-Maintenance-Statements.md
b/src/UserGuide/latest-Table/SQL-Manual/SQL-Maintenance-Statements.md
index 1a72ce7f..0500f17f 100644
--- a/src/UserGuide/latest-Table/SQL-Manual/SQL-Maintenance-Statements.md
+++ b/src/UserGuide/latest-Table/SQL-Manual/SQL-Maintenance-Statements.md
@@ -195,7 +195,7 @@ IoTDB> SHOW CURRENT_TIMESTAMP
```
-### 1.8 Viewing Region Information
+### 1.8 View Region Information
**Description**: Displays regions' information of the current cluster.
@@ -225,6 +225,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.9 View Available Nodes
+
+**Description**: Returns the RPC addresses and ports of all available
DataNodes in the current cluster. Note: A DataNode is considered "available" if
it is not in the REMOVING state.
+
+> This feature is supported starting from v2.0.8.
+
+**Syntax**:
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+**Result**:
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. Status Configuration
diff --git
a/src/UserGuide/latest-Table/User-Manual/Maintenance-commands_apache.md
b/src/UserGuide/latest-Table/User-Manual/Maintenance-commands_apache.md
index e2be89e6..659e7a5d 100644
--- a/src/UserGuide/latest-Table/User-Manual/Maintenance-commands_apache.md
+++ b/src/UserGuide/latest-Table/User-Manual/Maintenance-commands_apache.md
@@ -337,6 +337,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.10 Viewing Available Nodes
+
+**Description**: Returns the RPC addresses and ports of all available
DataNodes in the current cluster. Note: A DataNode is considered "available" if
it is not in the REMOVING state.
+
+> This feature is supported starting from v2.0.8.
+
+**Syntax**:
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+**Result**:
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. Status Setting
diff --git
a/src/UserGuide/latest-Table/User-Manual/Maintenance-commands_timecho.md
b/src/UserGuide/latest-Table/User-Manual/Maintenance-commands_timecho.md
index c4c4feec..02185325 100644
--- a/src/UserGuide/latest-Table/User-Manual/Maintenance-commands_timecho.md
+++ b/src/UserGuide/latest-Table/User-Manual/Maintenance-commands_timecho.md
@@ -337,6 +337,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.10 Viewing Available Nodes
+
+**Description**: Returns the RPC addresses and ports of all available
DataNodes in the current cluster. Note: A DataNode is considered "available" if
it is not in the REMOVING state.
+
+> This feature is supported starting from v2.0.8.
+
+**Syntax**:
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+**Result**:
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. Status Setting
diff --git a/src/UserGuide/latest/User-Manual/Maintenance-commands.md
b/src/UserGuide/latest/User-Manual/Maintenance-commands.md
index 070c0d24..b6d0988b 100644
--- a/src/UserGuide/latest/User-Manual/Maintenance-commands.md
+++ b/src/UserGuide/latest/User-Manual/Maintenance-commands.md
@@ -243,6 +243,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.7 Viewing Available Nodes
+
+**Description**: Returns the RPC addresses and ports of all available
DataNodes in the current cluster. Note: A DataNode is considered "available" if
it is not in the REMOVING state.
+
+> This feature is supported starting from v2.0.8.
+
+**Syntax**:
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+**Example**:
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+**Result**:
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. Status Setting
diff --git
a/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements.md
b/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements.md
index a04f40b9..4793ddd1 100644
--- a/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements.md
+++ b/src/zh/UserGuide/Master/Table/SQL-Manual/SQL-Maintenance-Statements.md
@@ -194,7 +194,6 @@ IoTDB> SHOW CURRENT_TIMESTAMP
+-----------------------------+
```
-
### 1.8 查看分区信息
**含义**：返回当前集群的分区信息。
@@ -225,6 +224,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.9 查看可用节点
+
+**含义**：返回当前集群所有可用的 DataNode 的 RPC 地址和端口。注意：这里对于“可用”的定义为：处于非 REMOVING 状态的 DN 节点。
+
+> V2.0.8 起支持该功能
+
+#### 语法：
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+执行结果如下：
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. 状态设置
diff --git
a/src/zh/UserGuide/Master/Table/User-Manual/Maintenance-statement_apache.md
b/src/zh/UserGuide/Master/Table/User-Manual/Maintenance-statement_apache.md
index 9f13e839..8c74bea3 100644
--- a/src/zh/UserGuide/Master/Table/User-Manual/Maintenance-statement_apache.md
+++ b/src/zh/UserGuide/Master/Table/User-Manual/Maintenance-statement_apache.md
@@ -336,6 +336,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.10 查看可用节点
+
+**含义**：返回当前集群所有可用的 DataNode 的 RPC 地址和端口。注意：这里对于“可用”的定义为：处于非 REMOVING 状态的 DN 节点。
+
+> V2.0.8 起支持该功能
+
+#### 语法：
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+执行结果如下：
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. 状态设置
diff --git
a/src/zh/UserGuide/Master/Table/User-Manual/Maintenance-statement_timecho.md
b/src/zh/UserGuide/Master/Table/User-Manual/Maintenance-statement_timecho.md
index bd526e7f..aadcb8b2 100644
--- a/src/zh/UserGuide/Master/Table/User-Manual/Maintenance-statement_timecho.md
+++ b/src/zh/UserGuide/Master/Table/User-Manual/Maintenance-statement_timecho.md
@@ -336,6 +336,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.10 查看可用节点
+
+**含义**：返回当前集群所有可用的 DataNode 的 RPC 地址和端口。注意：这里对于“可用”的定义为：处于非 REMOVING 状态的 DN 节点。
+
+> V2.0.8 起支持该功能
+
+#### 语法：
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+执行结果如下：
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. 状态设置
diff --git a/src/zh/UserGuide/Master/Tree/User-Manual/Maintenance-statement.md
b/src/zh/UserGuide/Master/Tree/User-Manual/Maintenance-statement.md
index 82a6746e..93259a49 100644
--- a/src/zh/UserGuide/Master/Tree/User-Manual/Maintenance-statement.md
+++ b/src/zh/UserGuide/Master/Tree/User-Manual/Maintenance-statement.md
@@ -212,6 +212,7 @@ IoTDB> SHOW QUERIES WHERE elapsedtime > 0.003
+-----------------------------+-----------------------+----------+-----------+--------------------------------------+
```
+
### 1.6 查看分区信息
**含义**：返回当前集群的分区信息。
@@ -243,6 +244,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.7 查看可用节点
+
+**含义**：返回当前集群所有可用的 DataNode 的 RPC 地址和端口。注意：这里对于“可用”的定义为：处于非 REMOVING 状态的 DN 节点。
+
+> V2.0.8 起支持该功能
+
+#### 语法：
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+执行结果如下：
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. 状态设置
diff --git
a/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Maintenance-Statements.md
b/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Maintenance-Statements.md
index 4bcac140..4793ddd1 100644
--- a/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Maintenance-Statements.md
+++ b/src/zh/UserGuide/latest-Table/SQL-Manual/SQL-Maintenance-Statements.md
@@ -224,6 +224,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.9 查看可用节点
+
+**含义**：返回当前集群所有可用的 DataNode 的 RPC 地址和端口。注意：这里对于“可用”的定义为：处于非 REMOVING 状态的 DN 节点。
+
+> V2.0.8 起支持该功能
+
+#### 语法：
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+执行结果如下：
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. 状态设置
diff --git
a/src/zh/UserGuide/latest-Table/User-Manual/Maintenance-statement_apache.md
b/src/zh/UserGuide/latest-Table/User-Manual/Maintenance-statement_apache.md
index 9f13e839..8c74bea3 100644
--- a/src/zh/UserGuide/latest-Table/User-Manual/Maintenance-statement_apache.md
+++ b/src/zh/UserGuide/latest-Table/User-Manual/Maintenance-statement_apache.md
@@ -336,6 +336,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.10 查看可用节点
+
+**含义**：返回当前集群所有可用的 DataNode 的 RPC 地址和端口。注意：这里对于“可用”的定义为：处于非 REMOVING 状态的 DN 节点。
+
+> V2.0.8 起支持该功能
+
+#### 语法：
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+执行结果如下：
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. 状态设置
diff --git
a/src/zh/UserGuide/latest-Table/User-Manual/Maintenance-statement_timecho.md
b/src/zh/UserGuide/latest-Table/User-Manual/Maintenance-statement_timecho.md
index bd526e7f..aadcb8b2 100644
--- a/src/zh/UserGuide/latest-Table/User-Manual/Maintenance-statement_timecho.md
+++ b/src/zh/UserGuide/latest-Table/User-Manual/Maintenance-statement_timecho.md
@@ -336,6 +336,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+----------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.10 查看可用节点
+
+**含义**：返回当前集群所有可用的 DataNode 的 RPC 地址和端口。注意：这里对于“可用”的定义为：处于非 REMOVING 状态的 DN 节点。
+
+> V2.0.8 起支持该功能
+
+#### 语法：
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+执行结果如下：
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. 状态设置
diff --git a/src/zh/UserGuide/latest/User-Manual/Maintenance-statement.md
b/src/zh/UserGuide/latest/User-Manual/Maintenance-statement.md
index c32cdc20..93259a49 100644
--- a/src/zh/UserGuide/latest/User-Manual/Maintenance-statement.md
+++ b/src/zh/UserGuide/latest/User-Manual/Maintenance-statement.md
@@ -244,6 +244,36 @@ IoTDB> SHOW REGIONS
+--------+------------+-------+-------------+-------------+-----------+----------+----------+-------+---------------+------+-----------------------+----------+
```
+### 1.7 查看可用节点
+
+**含义**：返回当前集群所有可用的 DataNode 的 RPC 地址和端口。注意：这里对于“可用”的定义为：处于非 REMOVING 状态的 DN 节点。
+
+> V2.0.8 起支持该功能
+
+#### 语法：
+
+```SQL
+showAvailableUrlsStatement
+ : SHOW AVAILABLE URLS
+ ;
+```
+
+#### 示例：
+
+```SQL
+IoTDB> SHOW AVAILABLE URLS
+```
+
+执行结果如下：
+
+```SQL
++----------+-------+
+|RpcAddress|RpcPort|
++----------+-------+
+| 0.0.0.0| 6667|
++----------+-------+
+```
+
## 2. 状态设置
