feat: Adjust cn file (#1596)

Chasen-Zhang · web-flow · commit b9cb3c9601b4 · 2025-02-06T11:30:50.000+08:00
* fix: cn parts

* chore: remove json

* feat: adjust docs

* fix: links

* feat: add cn miss
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/alter-warehouse.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/alter-warehouse.md
@@ -0,0 +1,71 @@
+---
+title: ALTER WAREHOUSE
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="引入或更新: v1.2.687"/>
+
+动态调整集群的配置，包括添加/删除集群、重命名集群以及分配/取消分配节点。
+
+## 语法
+
+```sql
+ALTER WAREHOUSE <warehouse_name>
+    [ADD CLUSTER <cluster_name> [WITH CLUSTER_SIZE = <size>] | (ASSIGN <node_count> NODES FROM <node_group>) ]
+  | [RENAME CLUSTER <old_cluster_name> TO <new_cluster_name>]
+  | [DROP CLUSTER <cluster_name>]
+  | [ASSIGN NODES (ASSIGN <node_count> NODES [FROM <node_group>] FOR <cluster_name>)]
+  | [UNASSIGN NODES (UNASSIGN <node_count> NODES [FROM <node_group>] FOR <cluster_name>)]
+
+```
+
+## 例子
+
+下面的例子将集群添加到现有的集群中：
+
+```sql
+ALTER WAREHOUSE test_warehouse ADD CLUSTER test_cluster WITH CLUSTER_SIZE = 3;
+```
+
+下面的示例重命名一个现有集群：
+
+```sql
+ALTER WAREHOUSE test_warehouse RENAME CLUSTER default TO test_cluster_2;
+```
+
+下面的例子删除一个已经存在的集群：
+
+```sql
+ALTER WAREHOUSE test_warehouse DROP CLUSTER test_cluster_2;
+```
+
+下面的例子将节点添加到现有的集群中：
+
+```sql
+ALTER WAREHOUSE test_warehouse ASSIGN NODES (ASSIGN 2 NODES FOR test_cluster);
+```
+
+下面的例子从现有的集群中删除节点：
+
+```sql
+ALTER WAREHOUSE test_warehouse UNASSIGN NODES (UNASSIGN 1 NODES FOR test_cluster);
+```
+
+下面的例子通过从特定的节点组中选择节点来创建集群：
+
+```sql
+ALTER WAREHOUSE test_warehouse ADD CLUSTER test_cluster (ASSIGN 1 NODES FROM dev_node, ASSIGN 1 NODES FROM infra_node);
+```
+
+下面的例子将特定节点组中的节点添加到现有的集群中：
+
+```sql
+ALTER WAREHOUSE test_warehouse ASSIGN NODES (ASSIGN 1 NODES FROM dev_node FOR default, ASSIGN 1 NODES FROM infra_node FOR default);
+```
+
+下面的例子从集群中的特定节点组中删除节点：
+
+```sql
+ALTER WAREHOUSE test_warehouse UNASSIGN NODES (UNASSIGN 1 NODES FROM dev_node FOR default, UNASSIGN 2 NODES FROM infra_node FOR default);
+```
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/create-warehouse.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/create-warehouse.md
@@ -0,0 +1,30 @@
+---
+title: CREATE WAREHOUSE
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="引入或更新: v1.2.687"/>
+
+创建具有指定大小的集群，或通过从特定节点组分配节点来创建集群。
+
+## 语法
+
+```sql
+CREATE WAREHOUSE <warehouse_name>
+[WITH warehouse_size = <size> | ( ASSIGN <node_count> NODES FROM <node_group>[, <node_count> NODES FROM <node_group> ... ] ) ]
+```
+
+## 例子
+
+下面的例子创建了一个大小为 10 的集群：
+
+```sql
+CREATE WAREHOUSE test_warehouse WITH warehouse_size = 10；
+```
+
+面的例子通过从节点组中分配特定的节点来创建一个集群：
+
+```sql
+CREATE WAREHOUSE test_warehouse (ASSIGN 1 NODES FROM log_node, ASSIGN 2 NODES FROM infra_node);
+```
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/drop-warehouse.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/drop-warehouse.md
@@ -0,0 +1,23 @@
+---
+title: DROP WAREHOUSE
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="引入或更新: v1.2.687"/>
+
+删除指定的集群并释放与之关联的资源。
+
+## 语法
+
+```sql
+DROP WAREHOUSE <warehouse_name>
+```
+
+## 例子
+
+下面的例子删除了 `test_warehouse` 集群：
+
+```sql
+DROP WAREHOUSE test_warehouse;
+```
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/index.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/index.md
@@ -0,0 +1,9 @@
+---
+title: Warehouse
+---
+
+import IndexOverviewList from '@site/src/components/IndexOverviewList';
+
+本页提供 Databend 中集群相关命令的参考信息。
+
+<IndexOverviewList />
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/rename-warehouse.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/rename-warehouse.md
@@ -0,0 +1,46 @@
+---
+title: RENAME WAREHOUSE
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="引入或更新: v1.2.687"/>
+
+将现有集群重命名为新名称。
+
+当您重命名集群时，如果尝试使用重命名的集群而不首先退出并重新连接，会话将遇到错误。这是因为会话仍然引用旧的集群名称。若要解决此问题，请退出当前会话，然后在尝试使用重命名的集群之前重新连接。
+
+```sql title='Example:'
+root@(test_warehouse_1)/default> rename warehouse test_warehouse_1 to test_warehouse;
+
+rename warehouse test_warehouse_1 to test_warehouse
+
+0 row read in 0.027 sec. Processed 0 row, 0 B (0 row/s, 0 B/s)
+
+root@(test_warehouse_1)/default> use warehouse test_warehouse;
+error: APIError: fail to POST http://localhost:8000/v1/query: BadRequest:(500 Internal Server Error)[500]Some(500) UnknownWarehouse. Code: 2406, Text = Unknown warehouse or self managed warehouse "test_warehouse_1"
+(while in warehouse request forward).
+
+root@(test_warehouse_1)/default> exit
+Bye~
+
+root@localhost:8000/default> use warehouse test_warehouse;
+
+use warehouse test_warehouse
+
+0 row read in 0.019 sec. Processed 0 row, 0 B (0 row/s, 0 B/s)
+```
+
+## 语法
+
+```sql
+RENAME WAREHOUSE <current_name> TO <new_name>
+```
+
+## 例子
+
+下面的例子将 `test_warehouse_1` 重命名为 `test_warehouse`：
+
+```sql
+RENAME WAREHOUSE test_warehouse_1 TO test_warehouse;
+```
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/resume-warehouse.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/resume-warehouse.md
@@ -0,0 +1,23 @@
+---
+title: RESUME WAREHOUSE
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="引入或更新: v1.2.687"/>
+
+重新启动先前挂起的集群，使其重新联机并重新分配其机器资源。如果没有可用节点，则 RESUME WAREHOUSE 命令将失败。在尝试恢复集群时，请确保有必要的资源可供集群成功重新启动。
+
+## 语法
+
+```sql
+RESUME WAREHOUSE <warehouse_name>
+```
+
+## 例子
+
+下面的例子恢复了 `test_warehouse` 集群：
+
+```sql
+RESUME WAREHOUSE test_warehouse;
+```
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/show-online-nodes.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/show-online-nodes.md
@@ -0,0 +1,36 @@
+---
+title: SHOW ONLINE NODES
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="引入或更新: v1.2.687"/>
+
+列出租户内所有当前在线的节点，显示节点 ID、类型、节点组、仓库、集群和版本等详细信息。
+
+## 语法
+
+```sql
+SHOW ONLINE NODES
+```
+
+## 例子
+
+```sql
+SHOW ONLINE NODES;
+
+┌─────────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│           id           │      type     │ node_group │ warehouse │ cluster │           version           │
+├────────────────────────┼───────────────┼────────────┼───────────┼─────────┼─────────────────────────────┤
+│ 9rabYMxa0ReDyZe6F9igH5 │ SystemManaged │ log_node   │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ CbzfLlTVO29EhkZXdeR625 │ SystemManaged │ log_node   │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ O0kOetbvkFjxrQ2kx4uMI  │ SystemManaged │ dev_node   │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ R2epWlGVd8S0maSTuwbsv4 │ SystemManaged │ dev_node   │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ SoZcaT4gmhVoGKcChlDw93 │ SystemManaged │ infra_node │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ UeNVzwHCXhxJTTB4Xonj07 │ SystemManaged │ dev_node   │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ Zu7rmhVZ2s2HqTUCdFBdu2 │ SystemManaged │ infra_node │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ bRubWZEzIibFgRgFad2MS3 │ SystemManaged │ infra_node │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ ilPer0ps5wWnEDOLIlk821 │ SystemManaged │ infra_node │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ shnWu1TC41sAxVwJMIVQF3 │ SystemManaged │ infra_node │           │         │ v1.2.665-nightly-bcb2c16f67 │
+└─────────────────────────────────────────────────────────────────────────────────────────────────────────┘
+```
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/show-warehouses.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/show-warehouses.md
@@ -0,0 +1,27 @@
+---
+title: SHOW WAREHOUSES
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="引入或更新: v1.2.687"/>
+
+返回所有现有集群的列表以及它们的类型和状态。
+
+## 语法
+
+```sql
+SHOW WAREHOUSES
+```
+
+## 例子
+
+```sql
+SHOW WAREHOUSES;
+
+┌───────────────────────────────────────────┐
+│    warehouse   │      type      │  status │
+├────────────────┼────────────────┼─────────┤
+│ test_warehouse │ System-Managed │ Running │
+└───────────────────────────────────────────┘
+```
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/suspend-warehouse.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/suspend-warehouse.md
@@ -0,0 +1,60 @@
+---
+title: SUSPEND WAREHOUSE
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="引入或更新: v1.2.687"/>
+
+挂起集群，释放关联的机器资源，但不删除集群。
+
+当您挂起一个集群时，它会释放与该集群关联的机器资源。但是，在尝试与集群交互时，此操作可能会导致问题。具体来说，如果尝试使用或查询挂起的集群，可能会遇到指示集群不可用的错误。例如，试图运行 SHOW ONLINE NODES 或引用挂起集群的其他命令将导致错误。要解决这个问题，您需要退出当前会话并重新连接。
+
+```sql title='Example:'
+root@(test_warehouse)/default> suspend warehouse test_warehouse;
+
+suspend warehouse test_warehouse
+
+0 row read in 0.036 sec. Processed 0 row, 0 B (0 row/s, 0 B/s)
+
+root@(test_warehouse)/default> show online nodes;
+error: APIError: fail to POST http://localhost:8000/v1/query: BadRequest:(400 Bad Request)[400]Some(400) UnknownWarehouse. Code: 2406, Text = Not find the 'test_warehouse' warehouse; it is possible that all nodes of the warehouse have gone offline. Please exit the client and reconnect, or use `use warehouse <new_warehouse>`.
+
+root@(test_warehouse_1)/default> exit
+Bye~
+
+root@localhost:8000/default> show online nodes;
+
+show online nodes
+
+┌─────────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│           id           │      type     │ node_group │ warehouse │ cluster │           version           │
+│         String         │     String    │   String   │   String  │  String │            String           │
+├────────────────────────┼───────────────┼────────────┼───────────┼─────────┼─────────────────────────────┤
+│ 9rabYMxa0ReDyZe6F9igH5 │ SystemManaged │ log_node   │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ CbzfLlTVO29EhkZXdeR625 │ SystemManaged │ log_node   │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ O0kOetbvkFjxrQ2kx4uMI  │ SystemManaged │ dev_node   │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ R2epWlGVd8S0maSTuwbsv4 │ SystemManaged │ dev_node   │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ SoZcaT4gmhVoGKcChlDw93 │ SystemManaged │ infra_node │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ UeNVzwHCXhxJTTB4Xonj07 │ SystemManaged │ dev_node   │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ Zu7rmhVZ2s2HqTUCdFBdu2 │ SystemManaged │ infra_node │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ bRubWZEzIibFgRgFad2MS3 │ SystemManaged │ infra_node │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ ilPer0ps5wWnEDOLIlk821 │ SystemManaged │ infra_node │           │         │ v1.2.665-nightly-bcb2c16f67 │
+│ shnWu1TC41sAxVwJMIVQF3 │ SystemManaged │ infra_node │           │         │ v1.2.665-nightly-bcb2c16f67 │
+└─────────────────────────────────────────────────────────────────────────────────────────────────────────┘
+10 rows read in 0.133 sec. Processed 0 rows, 0 B (0 row/s, 0 B/s)
+```
+
+## 语法
+
+```sql
+SUSPEND WAREHOUSE <warehouse_name>
+```
+
+## 例子
+
+下面的例子挂起了 `test_warehouse` 集群：
+
+```sql
+SUSPEND WAREHOUSE test_warehouse;
+```
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/use-warehouse.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/use-warehouse.md
@@ -0,0 +1,23 @@
+---
+title: USE WAREHOUSE
+---
+
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="引入或更新: v1.2.687"/>
+
+设置用于执行查询的活动集群。
+
+## 语法
+
+```sql
+USE WAREHOUSE <warehouse_name>
+```
+
+## 例子
+
+下面的例子将 `test_warehouse` 设置为活动集群：
+
+```sql
+USE WAREHOUSE test_warehouse;
+```
