morrySnow commented on code in PR #1896:
URL: https://github.com/apache/doris-website/pull/1896#discussion_r1923804512
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/cluster-management/instance-management/DECOMMISSION-BACKEND.md:
##########
@@ -24,50 +24,56 @@ specific language governing permissions and limitations
under the License.
-->
-
-
-
-
## 描述
-节点下线操作用于安全下线节点。该操作为异步操作。如果成功，节点最终会从元数据中删除。如果失败，则不会完成下线（仅管理员使用！）
-
-语法：
+该语句用于将 BE 节点安全地从集群中下线。该操作为异步操作。
-- 通过 host 和 port 查找 backend
+## 语法
```sql
-ALTER SYSTEM DECOMMISSION BACKEND
"host:heartbeat_port"[,"host:heartbeat_port"...];
+ALTER SYSTEM DECOMMISSION BACKEND "<be_identifier>" [, "<be_identifier>" ... ]
```
-- 通过 backend_id 查找 backend
+其中：
```sql
-ALTER SYSTEM DECOMMISSION BACKEND "id1","id2"...;
+be_identifier
+ : "<be_host>:<be_heartbeat_port>"
+ | "<backend_id>"
```
- 说明：
+:::tip
Review Comment:
同上
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/cluster-management/instance-management/MODIFY-BACKEND.md:
##########
@@ -25,77 +24,67 @@ specific language governing permissions and limitations
under the License.
-->
-
-
-
## 描述
-修改 BE 节点属性（仅管理员使用！）
+该语句用于修改 BE 节点属性，修改 BE 节点属性后，会影响到当前的节点的查询、写入和数据分布。以下是支持修改的属性：
-语法：
+| 属性 | 影响
|
+|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `tag.location` | BE 的标签名，默认值为`default`。修改后，会影响到同一标签组内的 BE 数据均衡，以及在建表时，数据分布的
BE 节点。更多信息可参考[Resource
Group](../../../../admin-manual/workload-management/resource-group.md) |
+| `disable_query` | 是否禁用查询，默认为`false`。设置为`true`后，将不会再有新的查询请求规划到这台 BE 节点上。
|
+| `disable_load` | 是否禁用导入，默认为`false`。设置为`true`后，将不会再有新的导入请求规划到这台 BE 节点上。
|
-- 通过 host 和 port 查找 backend
+## 语法
```sql
-ALTER SYSTEM MODIFY BACKEND "host:heartbeat_port" SET ("key" = "value"[, ...]);
+ALTER SYSTEM MODIFY BACKEND <be_identifier> [, <be_identifier> [...] ]
+SET (
+ "<key>" = "<value>"
+)
```
-- 通过 backend_id 查找 backend
+其中：
```sql
-ALTER SYSTEM MODIFY BACKEND "id1" SET ("key" = "value"[, ...]);
+be_identifier
+ : "<be_host>:<be_heartbeat_port>"
+ | "<backend_id>"
```
- 说明：
+:::tip
Review Comment:
同上
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/cluster-management/instance-management/DROP-BACKEND.md:
##########
@@ -24,47 +24,59 @@ specific language governing permissions and limitations
under the License.
-->
-
-
## 描述
-该语句用于删除 BACKEND 节点（仅管理员使用！）
+该语句用于将 BE 节点从 Doris 集群中删除。
-语法：
-
-- 通过 host 和 port 查找 backend
+## 语法
```sql
-ALTER SYSTEM DROP BACKEND "host:heartbeat_port"[,"host:heartbeat_port"...]
+ALTER SYSTEM DROP BACKEND "<be_identifier>" [, "<be_identifier>" ... ]
```
-- 通过 backend_id 查找 backend
+其中：
```sql
-ALTER SYSTEM DROP BACKEND "id1","id2"...;
+be_identifier
+ : "<be_host>:<be_heartbeat_port>"
+ | "<backend_id>"
```
-说明：
+:::tip
Review Comment:
同上
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/cluster-management/instance-management/CANCEL-ALTER-SYSTEM.md:
##########
@@ -24,45 +24,49 @@ specific language governing permissions and limitations
under the License.
-->
-
-
-
-
## 描述
-该语句用于撤销一个节点下线操作。（仅管理员使用！）
-
-语法：
+该语句用于撤销一个节点下线操作。
-- 通过 host 和 port 查找 backend
+## 语法
```sql
-CANCEL DECOMMISSION BACKEND "host:heartbeat_port"[,"host:heartbeat_port"...];
+CANCEL DECOMMISSION BACKEND "<be_identifier>" [, "<be_identifier>" ... ]
```
-- 通过 backend_id 查找 backend
+其中：
```sql
-CANCEL DECOMMISSION BACKEND "id1","id2","id3...";
+be_identifier
+ : "<be_host>:<be_heartbeat_port>"
+ | "<backend_id>"
```
-## 示例
Review Comment:
还是需要一个参数章节介绍这些参数的含义
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/cluster-management/instance-management/MODIFY-BACKEND.md:
##########
@@ -25,77 +24,67 @@ specific language governing permissions and limitations
under the License.
-->
-
-
-
## 描述
-修改 BE 节点属性（仅管理员使用！）
+该语句用于修改 BE 节点属性，修改 BE 节点属性后，会影响到当前的节点的查询、写入和数据分布。以下是支持修改的属性：
-语法：
+| 属性 | 影响
|
+|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `tag.location` | BE 的标签名，默认值为`default`。修改后，会影响到同一标签组内的 BE 数据均衡，以及在建表时，数据分布的
BE 节点。更多信息可参考[Resource
Group](../../../../admin-manual/workload-management/resource-group.md) |
+| `disable_query` | 是否禁用查询，默认为`false`。设置为`true`后，将不会再有新的查询请求规划到这台 BE 节点上。
|
+| `disable_load` | 是否禁用导入，默认为`false`。设置为`true`后，将不会再有新的导入请求规划到这台 BE 节点上。
|
-- 通过 host 和 port 查找 backend
+## 语法
```sql
-ALTER SYSTEM MODIFY BACKEND "host:heartbeat_port" SET ("key" = "value"[, ...]);
+ALTER SYSTEM MODIFY BACKEND <be_identifier> [, <be_identifier> [...] ]
+SET (
+ "<key>" = "<value>"
+)
```
-- 通过 backend_id 查找 backend
+其中：
```sql
-ALTER SYSTEM MODIFY BACKEND "id1" SET ("key" = "value"[, ...]);
+be_identifier
+ : "<be_host>:<be_heartbeat_port>"
+ | "<backend_id>"
```
- 说明：
Review Comment:
同上
##########
i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-statements/cluster-management/instance-management/SHOW-BACKENDS.md:
##########
@@ -24,40 +24,72 @@ specific language governing permissions and limitations
under the License.
-->
-
-
-
-
## 描述
-该语句用于查看 cluster 内的 BE 节点
+该语句用于查看 BE 节点的基本状态信息。
+
+## 语法
```sql
SHOW BACKENDS;
Review Comment:
去掉分号吧
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For queries about this service, please contact Infrastructure at:
us...@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@doris.apache.org
For additional commands, e-mail: commits-h...@doris.apache.org
