AI Translate 20-workload-group to Simplified-Chinese (#2517)

github-actions[bot] · web-flow · commit 572ba28a34e4 · 2025-07-18T23:20:41.000+08:00
* [INIT] Start translation to Simplified-Chinese

* 🌐 Translate create-workload-group.md to Simplified-Chinese

* 🌐 Translate create-workload-group.md to Simplified-Chinese

* 🌐 Translate create-workload-group.md to Simplified-Chinese

* 🌐 Translate create-workload-group.md to Simplified-Chinese

---------

Co-authored-by: github-actions[bot] &lt;github-actions[bot]@users.noreply.github.com&gt;
diff --git a/.translation-init b/.translation-init
@@ -1 +1 @@
-Translation initialization: 2025-07-18T12:16:47.204077
+Translation initialization: 2025-07-18T13:29:15.044160
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/create-workload-group.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/create-workload-group.md
@@ -5,7 +5,7 @@ import FunctionDescription from '@site/src/components/FunctionDescription';
 
 <FunctionDescription description="引入或更新于：v1.2.743"/>
 
-创建一个具有指定配额设置的工作负载组 (Workload Group)。
+创建一个具有指定配额设置的工作负载组（Workload Group）。工作负载组（Workload Group）通过与用户绑定来控制资源分配和查询（Query）并发。当用户提交查询（Query）时，系统会根据用户所属的工作负载组（Workload Group）自动应用相应的资源限制。
 
 ## 语法
 
@@ -16,16 +16,73 @@ CREATE WORKLOAD GROUP [IF NOT EXISTS] <group_name>
 
 ## 参数
 
-| 参数                   | 类型            | 是否必需 | 默认值      | 描述                                                                                                                            |
-|------------------------|-----------------|----------|-------------|---------------------------------------------------------------------------------------------------------------------------------|
-| `cpu_quota`            | string          | 否       | (无限制)    | CPU 资源配额，以百分比字符串表示（例如 `"20%"`）                                                                                  |
-| `query_timeout`        | duration        | 否       | (无限制)    | 查询超时时长（单位：`s`/`sec`=秒，`m`/`min`=分钟，`h`/`hour`=小时，`d`/`day`=天，`ms`=毫秒，无单位=秒）                               |
-| `memory_quota`         | string or integer | 否       | (无限制)    | 工作负载组的最大内存使用限制（百分比或绝对值）                                                                                    |
-| `max_concurrency`      | integer         | 否       | (无限制)    | 工作负载组的最大并发数                                                                                                            |
-| `query_queued_timeout` | duration        | 否       | (无限制)    | 当工作负载组超过最大并发数时的最大排队等待时间（单位：`s`/`sec`=秒，`m`/`min`=分钟，`h`/`hour`=小时，`d`/`day`=天，`ms`=毫秒，无单位=秒） |
+| 参数                   | 类型             | 是否必需 | 默认值      | 描述                                                                         |
+|------------------------|------------------|----------|-------------|------------------------------------------------------------------------------|
+| `cpu_quota`            | string           | 否       | (无限制)    | CPU 资源配额，以百分比字符串表示（例如 `"20%"`）                             |
+| `query_timeout`        | duration         | 否       | (无限制)    | 查询（Query）超时时长（单位：`s`/`sec`=秒，`m`/`min`=分钟，`h`/`hour`=小时，`d`/`day`=天，`ms`=毫秒，无单位=秒） |
+| `memory_quota`         | string 或 integer | 否       | (无限制)    | 工作负载组（Workload Group）的最大内存使用限制（百分比或绝对值）             |
+| `max_concurrency`      | integer          | 否       | (无限制)    | 工作负载组（Workload Group）的最大并发数                                     |
+| `query_queued_timeout` | duration         | 否       | (无限制)    | 工作负载组（Workload Group）超出最大并发时的最大排队等待时间（单位：`s`/`sec`=秒，`m`/`min`=分钟，`h`/`hour`=小时，`d`/`day`=天，`ms`=毫秒，无单位=秒） |
 
 ## 示例
 
+### 基本示例
+
 ```sql
-CREATE WORKLOAD GROUP analytics WITH cpu_quota = '20%', query_timeout = '10m';
-```
+-- 创建工作负载组
+CREATE WORKLOAD GROUP IF NOT EXISTS interactive_queries 
+WITH cpu_quota = '30%', memory_quota = '20%', max_concurrency = 2;
+
+CREATE WORKLOAD GROUP IF NOT EXISTS batch_processing 
+WITH cpu_quota = '70%', memory_quota = '80%', max_concurrency = 10;
+```
+
+### 用户分配
+
+用户必须分配到工作负载组（Workload Group）才能启用资源限制。当用户执行查询（Query）时，系统会自动应用该工作负载组（Workload Group）的限制。
+
+```sql
+-- 创建并分配用户
+CREATE USER analytics_user IDENTIFIED BY 'password123';
+ALTER USER analytics_user WITH SET WORKLOAD GROUP = 'interactive_queries';
+
+-- 重新分配到不同工作负载组
+ALTER USER analytics_user WITH SET WORKLOAD GROUP = 'batch_processing';
+
+-- 从工作负载组移除（用户将使用默认无限制资源）
+ALTER USER analytics_user WITH UNSET WORKLOAD GROUP;
+
+-- 检查用户的工作负载组
+DESC USER analytics_user;
+```
+
+## 资源配额归一化
+
+### 配额限制
+- 每个工作负载组（Workload Group）的 `cpu_quota` 和 `memory_quota` 最高可设为 `100%` (1.0)
+- 所有工作负载组（Workload Group）的配额总和可超过 100%
+- 实际资源分配会基于相对比例进行**归一化**
+
+### 配额归一化原理
+
+资源按各组配额占总配额的比例分配：
+
+```
+实际分配 = (组配额) / (所有组配额总和) × 100%
+```
+
+**示例 1：总配额 = 100%**
+- 组 A：30% 配额 → 获得 30% 资源 (30/100)
+- 组 B：70% 配额 → 获得 70% 资源 (70/100)
+
+**示例 2：总配额 > 100%**
+- 组 A：60% 配额 → 获得 40% 资源 (60/150)
+- 组 B：90% 配额 → 获得 60% 资源 (90/150)
+- 总配额：150%
+
+**示例 3：总配额 < 100%**
+- 组 A：20% 配额 → 获得 67% 资源 (20/30)
+- 组 B：10% 配额 → 获得 33% 资源 (10/30)
+- 总配额：30%
+
+**特殊情况：** 当仅存在一个工作负载组（Workload Group）时，无论其配置配额如何，都将获得 100% 的计算集群（Warehouse）资源。
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/drop-workload-group.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/drop-workload-group.md
@@ -3,9 +3,9 @@ title: DROP WORKLOAD GROUP
 ---
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="引入或更新于: v1.2.743"/>
+<FunctionDescription description="引入或更新于：v1.2.743"/>
 
-删除指定的工作负载组。
+移除指定的工作负载组（Workload Group）。
 
 ## 语法
 
@@ -15,8 +15,8 @@ DROP WORKLOAD GROUP [IF EXISTS] <workload_group_name>
 
 ## 示例
 
-此示例删除 `test_workload_group` 工作负载组:
+此示例移除了工作负载组 `test_workload_group`：
 
 ```sql
-DROP WORKLOAD GROUP test_warehouse;
+DROP WORKLOAD GROUP test_workload_group;
 ```
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/index.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/index.md
@@ -2,23 +2,40 @@
 title: 工作负载组（Workload Group）
 ---
 
-本页面全面概述了 Databend 中工作负载组的操作指南，按功能分类以便查阅。
+工作负载组（Workload Group）通过为不同用户组分配 CPU、内存配额和限制并发查询，在 Databend 中实现资源管理与查询并发控制。
 
-## 工作负载组管理
+## 工作原理
 
+1. **创建工作负载组**，并指定资源配额（CPU、内存、并发限制）
+2. 使用 `ALTER USER` **将用户分配**到工作负载组
+3. **执行查询**时自动应用用户所在工作负载组的资源限制
+
+## 快速示例
+
+```sql
+-- 创建工作负载组
+CREATE WORKLOAD GROUP analytics WITH cpu_quota = '50%', memory_quota = '30%', max_concurrency = 5;
+
+-- 将用户分配到工作负载组
+CREATE USER analyst IDENTIFIED BY 'password';
+ALTER USER analyst WITH SET WORKLOAD GROUP = 'analytics';
+```
+
+## 命令参考
+
+### 管理
 | 命令 | 描述 |
 |---------|-------------|
-| [CREATE WORKLOAD GROUP](create-workload-group.md) | 创建用于资源管理的新工作负载组 |
-| [ALTER WORKLOAD GROUP](alter-workload-group.md) | 修改现有工作负载组配置 |
-| [DROP WORKLOAD GROUP](drop-workload-group.md) | 删除工作负载组 |
+| [CREATE WORKLOAD GROUP](create-workload-group.md) | 创建带资源配额的新工作负载组 |
+| [ALTER WORKLOAD GROUP](alter-workload-group.md) | 修改工作负载组配置 |
+| [DROP WORKLOAD GROUP](drop-workload-group.md) | 移除工作负载组 |
 | [RENAME WORKLOAD GROUP](rename-workload-group.md) | 重命名工作负载组 |
 
-## 工作负载组信息
-
+### 信息
 | 命令 | 描述 |
 |---------|-------------|
-| [SHOW WORKLOAD GROUPS](show-workload-groups.md) | 列出所有工作负载组及其配置 |
+| [SHOW WORKLOAD GROUPS](show-workload-groups.md) | 列出所有工作负载组及其设置 |
 
-:::note
-Databend 中的工作负载组允许您管理和优先分配不同类型查询和用户的资源，有助于优化性能和资源利用率。
+:::tip
+在计算集群（Warehouse）中，所有工作负载组的资源配额会被归一化处理。例如，若两组 CPU 配额分别为 60% 和 40%，则它们将分别获得实际资源的 60% 和 40%。
 :::
diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/rename-workload-group.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/rename-workload-group.md
@@ -3,9 +3,9 @@ title: RENAME WORKLOAD GROUP
 ---
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="引入或更新于: v1.2.743"/>
+<FunctionDescription description="引入或更新于：v1.2.743"/>
 
-将现有的工作负载组重命名为新名称。
+将现有工作负载组（Workload Group）重命名为新名称。
 
 ## 语法
 
@@ -15,8 +15,8 @@ RENAME WORKLOAD GROUP <current_name> TO <new_name>
 
 ## 示例
 
-此示例将 `test_workload_group_1` 重命名为 `test_workload_group`:
+本示例将 `test_workload_group_1` 重命名为 `test_workload_group`：
 
 ```sql
-RENAME WAREHOUSE test_workload_group_1 TO test_workload_group;
+RENAME WORKLOAD GROUP test_workload_group_1 TO test_workload_group;
 ```

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-Translation initialization: 2025-07-18T12:16:47.204077`
	`1`	`+Translation initialization: 2025-07-18T13:29:15.044160`