docs: simplify warehouse SQL docs (#3038)

* docs: simplify warehouse SQL docs

- Update CREATE WAREHOUSE syntax and examples
- Remove self-hosted-only warehouse pages from SQL reference
- Add self-hosted warehouse SQL reference page (nodes/clusters)

* docs: align warehouse docs with MCP execution

- Use warehouse names compatible with execution
- Remove unsupported warehouse commands from SQL reference
- Document node/cluster commands under self-hosted references

* docs: clarify quoting for hyphenated warehouse names

* docs: align warehouse examples with quoting

* docs: simplify warehouse quoting and self-hosted refs

Author: BohuTANG

docs/cn/guides/20-self-hosted/04-references/warehouse-sql-commands.md

@@ -0,0 +1,90 @@
+---
+title: 计算集群 SQL 命令
+---
+
+本页列出在自建部署中启用系统管理（system-managed）资源管理后，可用于管理计算集群的 SQL 命令。
+
+## SHOW ONLINE NODES
+
+列出租户中当前在线的查询节点。
+
+```sql
+SHOW ONLINE NODES
+```
+
+```sql
+SHOW ONLINE NODES;
+```
+
+## CREATE WAREHOUSE
+
+通过指定节点数量创建系统管理的计算集群。
+
+```sql
+CREATE WAREHOUSE <warehouse_name>
+    WITH warehouse_size = <node_count>
+```
+
+```sql
+CREATE WAREHOUSE wh1 WITH warehouse_size = 2;
+```
+
+## ALTER WAREHOUSE
+
+用于管理计算集群中的集群（cluster）。
+
+```sql
+ALTER WAREHOUSE <warehouse_name>
+    ADD CLUSTER <cluster_name> WITH CLUSTER_SIZE = <node_count>
+
+ALTER WAREHOUSE <warehouse_name>
+    RENAME CLUSTER <old_cluster_name> TO <new_cluster_name>
+
+ALTER WAREHOUSE <warehouse_name>
+    DROP CLUSTER <cluster_name>
+```
+
+```sql
+ALTER WAREHOUSE wh1 ADD CLUSTER c1 WITH CLUSTER_SIZE = 2;
+```
+
+## RENAME WAREHOUSE
+
+重命名计算集群。
+
+```sql
+RENAME WAREHOUSE <current_name> TO <new_name>
+```
+
+```sql
+RENAME WAREHOUSE wh1 TO wh1_new;
+```
+
+## SUSPEND WAREHOUSE
+
+暂停计算集群。
+
+```sql
+SUSPEND WAREHOUSE <warehouse_name>
+```
+
+```sql
+SUSPEND WAREHOUSE wh1;
+```
+
+## RESUME WAREHOUSE
+
+恢复已暂停的计算集群。
+
+```sql
+RESUME WAREHOUSE <warehouse_name>
+```
+
+```sql
+RESUME WAREHOUSE wh1;
+```
+
+## 另请参阅
+
+- [USE WAREHOUSE](/sql/sql-commands/ddl/warehouse/use-warehouse)
+- [DROP WAREHOUSE](/sql/sql-commands/ddl/warehouse/drop-warehouse)

docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/alter-warehouse.md

@@ -6,25 +6,24 @@ import FunctionDescription from '@site/src/components/FunctionDescription';
 
 <FunctionDescription description="引入或更新于：v1.2.687"/>
 
-创建一个具有指定大小的计算集群（Warehouse），或通过从特定节点组分配节点来创建。
+创建一个具有指定大小的计算集群。
 
 ## 语法
 
 ```sql
-CREATE WAREHOUSE <warehouse_name>
-[WITH warehouse_size = <size> | ( ASSIGN <node_count> NODES FROM <node_group>[, <node_count> NODES FROM <node_group> ... ] ) ]
+CREATE WAREHOUSE '<warehouse_name>'
+    WITH WAREHOUSE_SIZE = '<warehouse_size>'
 ```
 
-## 示例
+说明：
 
-此示例创建一个大小为 10 的计算集群（Warehouse）：
+- `<warehouse_name>` 只能包含英文字母、数字和 `-`。建议统一使用单引号包裹。
+- `<warehouse_size>` 不区分大小写，可选值为：`XSMALL`、`SMALL`、`MEDIUM`、`LARGE`、`XLARGE`、`XXLARGE`、`XXXLARGE`。建议统一使用单引号包裹。
 
-```sql
-CREATE WAREHOUSE test_warehouse WITH warehouse_size = 10;
-```
+## 示例
 
-此示例通过从特定节点组分配节点来创建一个计算集群（Warehouse）：
+此示例创建一个 `XSMALL` 规格的计算集群：
 
 ```sql
-CREATE WAREHOUSE test_warehouse (ASSIGN 1 NODES FROM log_node, ASSIGN 2 NODES FROM infra_node);
-```
+CREATE WAREHOUSE 'testwarehouse' WITH WAREHOUSE_SIZE = 'XSMALL';
+```

docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/create-warehouse.md

@@ -3,20 +3,22 @@ title: DROP WAREHOUSE
 ---
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="Introduced or updated: v1.2.687"/>
+<FunctionDescription description="引入或更新于：v1.2.687"/>
 
 删除指定的计算集群并释放与其关联的资源。
 
 ## 语法
 
 ```sql
-DROP WAREHOUSE <warehouse_name>
+DROP WAREHOUSE '<warehouse_name>'
 ```
 
+建议统一使用单引号包裹 `<warehouse_name>`。
+
 ## 示例
 
-此示例删除 `test_warehouse` 计算集群：
+此示例删除 `testwarehouse` 计算集群：
 
 ```sql
-DROP WAREHOUSE test_warehouse;
-```
+DROP WAREHOUSE 'testwarehouse';
+```

docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/drop-warehouse.md

@@ -2,27 +2,22 @@
 title: 计算集群（Warehouse）
 ---
 
-本页面全面概述了 Databend 中计算集群的操作，按功能分类，便于参考。
+计算集群相关的 SQL 命令。
 
 ## 计算集群管理
 
 | 命令 | 描述 |
 |---------|-------------|
 | [CREATE WAREHOUSE](create-warehouse.md) | 创建新的计算集群用于计算资源 |
-| [ALTER WAREHOUSE](alter-warehouse.md) | 修改现有计算集群的配置 |
 | [DROP WAREHOUSE](drop-warehouse.md) | 删除计算集群 |
-| [RENAME WAREHOUSE](rename-warehouse.md) | 更改计算集群的名称 |
-| [SUSPEND WAREHOUSE](suspend-warehouse.md) | 临时停止计算集群以节省资源 |
-| [RESUME WAREHOUSE](resume-warehouse.md) | 重启已暂停的计算集群 |
 | [USE WAREHOUSE](use-warehouse.md) | 为当前会话设置计算集群 |
 
 ## 计算集群信息
 
 | 命令 | 描述 |
 |---------|-------------|
 | [SHOW WAREHOUSES](show-warehouses.md) | 列出所有计算集群 |
-| [SHOW ONLINE NODES](show-online-nodes.md) | 显示当前计算集群中的活跃计算节点 |
 
 :::note
-Databend 中的计算集群代表执行查询（Query）的计算资源。它们可以根据工作负载需求进行扩容或缩容，并在不使用时暂停以优化成本。
-:::
+计算集群代表用于执行查询的计算资源。
+:::

docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/index.md

@@ -3,9 +3,11 @@ title: SHOW WAREHOUSES
 ---
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="Introduced or updated: v1.2.687"/>
+<FunctionDescription description="引入或更新于：v1.2.687"/>
 
-返回所有现有计算集群的列表，以及它们的类型和状态。
+列出当前租户下的所有计算集群。
+
+结果包含 `name`、`state`、`size`、`version`、`auto_suspend`、`cache_size`、`spill_size`、`created_on` 等列。
 
 ## 语法
 
@@ -17,10 +19,4 @@ SHOW WAREHOUSES
 
 ```sql
 SHOW WAREHOUSES;
-
-┌───────────────────────────────────────────┐
-│    warehouse   │      type      │  status │
-├────────────────┼────────────────┼─────────┤
-│ test_warehouse │ System-Managed │ Running │
-└───────────────────────────────────────────┘
-```
+```