add show available urls to maintenance statements from 208 (#973)

Author: leto-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
 

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
 

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
 

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
 

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
 

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
 

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
 

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
 

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. 状态设置