From 771ab42b0a3308fab790cd9c12a88619b4829061 Mon Sep 17 00:00:00 2001 From: Leto_b Date: Tue, 20 Jan 2026 14:38:37 +0800 Subject: [PATCH] add show available urls to maintenance statements from 208 --- .../SQL-Manual/SQL-Maintenance-Statements.md | 32 ++++++++++++++++++- .../Maintenance-commands_apache.md | 30 +++++++++++++++++ .../Maintenance-commands_timecho.md | 30 +++++++++++++++++ .../Tree/User-Manual/Maintenance-commands.md | 31 +++++++++++++++++- .../SQL-Manual/SQL-Maintenance-Statements.md | 32 ++++++++++++++++++- .../Maintenance-commands_apache.md | 30 +++++++++++++++++ .../Maintenance-commands_timecho.md | 30 +++++++++++++++++ .../User-Manual/Maintenance-commands.md | 30 +++++++++++++++++ .../SQL-Manual/SQL-Maintenance-Statements.md | 31 +++++++++++++++++- .../Maintenance-statement_apache.md | 30 +++++++++++++++++ .../Maintenance-statement_timecho.md | 30 +++++++++++++++++ .../Tree/User-Manual/Maintenance-statement.md | 31 ++++++++++++++++++ .../SQL-Manual/SQL-Maintenance-Statements.md | 30 +++++++++++++++++ .../Maintenance-statement_apache.md | 30 +++++++++++++++++ .../Maintenance-statement_timecho.md | 30 +++++++++++++++++ .../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 1a72ce7fe..0500f17f0 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 e2be89e66..659e7a5d1 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 c4c4feec5..02185325c 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 27a286b5d..b6d0988bd 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 1a72ce7fe..0500f17f0 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 e2be89e66..659e7a5d1 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 c4c4feec5..02185325c 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 070c0d242..b6d0988bd 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 a04f40b96..4793ddd1f 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 9f13e8397..8c74bea38 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 bd526e7fa..aadcb8b29 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 82a6746e0..93259a49a 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 4bcac1408..4793ddd1f 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 9f13e8397..8c74bea38 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 bd526e7fa..aadcb8b29 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 c32cdc200..93259a49a 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. 状态设置