add workload group docs (#2257)

* add workload group docs

* add workload group docs

* add workload group docs

---------

Co-authored-by: z <[email protected]>

Author: zhang2014

docs/en/sql-reference/10-sql-commands/00-ddl/20-workload-group/alter-workload-group.md

@@ -0,0 +1,30 @@
+---
+title: ALTER WORKLOAD GROUP
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.743"/>
+
+Update a workload group with specified quota settings.
+
+## Syntax
+
+```sql
+ALTER WORKLOAD GROUP <group_name>
+[SET cpu_quota = '<percentage>', query_timeout = '<duration>']
+```
+
+## Parameters
+
+| Parameter       | Type     | Required | Default      | Description                                                                 |
+|-----------------|----------|----------|--------------|-----------------------------------------------------------------------------|
+| `cpu_quota`     | string   | No       | (unlimited)  | CPU resource quota as percentage string (e.g. `"20%"`)                      |
+| `query_timeout` | duration | No       | (unlimited)  | Query timeout duration (units: `s`/`sec`=seconds, `m`/`min`=minutes, `h`/`hour`=hours, `d`/`day`=days, `ms`=milliseconds, unitless=seconds) |
+
+
+## Examples
+
+```sql
+ALTER WORKLOAD GROUP analytics SET cpu_quota = '20%', query_timeout = '10m';
+```
+

docs/en/sql-reference/10-sql-commands/00-ddl/20-workload-group/create-workload-group.md

@@ -0,0 +1,30 @@
+---
+title: CREATE WORKLOAD GROUP
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.743"/>
+
+Creates a workload group with specified quota settings.
+
+## Syntax
+
+```sql
+CREATE WORKLOAD GROUP [IF NOT EXISTS] <group_name>
+[WITH cpu_quota = '<percentage>', query_timeout = '<duration>']
+```
+
+## Parameters
+
+| Parameter       | Type     | Required | Default      | Description                                                                 |
+|-----------------|----------|----------|--------------|-----------------------------------------------------------------------------|
+| `cpu_quota`     | string   | No       | (unlimited)  | CPU resource quota as percentage string (e.g. `"20%"`)                      |
+| `query_timeout` | duration | No       | (unlimited)  | Query timeout duration (units: `s`/`sec`=seconds, `m`/`min`=minutes, `h`/`hour`=hours, `d`/`day`=days, `ms`=milliseconds, unitless=seconds) |
+
+
+## Examples
+
+```sql
+CREATE WORKLOAD GROUP analytics WITH cpu_quota = '20%', query_timeout = '10m';
+```
+

docs/en/sql-reference/10-sql-commands/00-ddl/20-workload-group/drop-workload-group.md

@@ -0,0 +1,22 @@
+---
+title: DROP WORKLOAD GROUP
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.743"/>
+
+Removes the specified workload group. 
+
+## Syntax
+
+```sql
+DROP WORKLOAD GROUP [IF EXISTS] <workload_group_name>
+```
+
+## Examples
+
+This example removes the `test_workload_group` workload group:
+
+```sql
+DROP WORKLOAD GROUP test_warehouse;
+```

docs/en/sql-reference/10-sql-commands/00-ddl/20-workload-group/index.md

@@ -0,0 +1,8 @@
+---
+title: Workload Group
+---
+import IndexOverviewList from '@site/src/components/IndexOverviewList';
+
+This page provides reference information for the workload-group-related commands in Databend.
+
+<IndexOverviewList />

docs/en/sql-reference/10-sql-commands/00-ddl/20-workload-group/rename-workload-group.md

@@ -0,0 +1,23 @@
+---
+title: RENAME WORKLOAD GROUP
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.743"/>
+
+Renames an existing workload group to a new name.
+
+## Syntax
+
+```sql
+RENAME WORKLOAD GROUP <current_name> TO <new_name>
+```
+
+## Examples
+
+This example renames `test_workload_group_1` to `test_workload_group`:
+
+```sql
+RENAME WAREHOUSE test_workload_group_1 TO test_workload_group;
+```
+

docs/en/sql-reference/10-sql-commands/00-ddl/20-workload-group/show-workload-groups.md

@@ -0,0 +1,27 @@
+---
+title: SHOW WORKLOAD GROUPS
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.743"/>
+
+Returns a list of all existing workload groups along with their quotas.
+
+## Syntax
+
+```sql
+SHOW WORKLOAD GROUPS
+```
+
+## Examples
+
+```sql
+SHOW WORKLOAD GROUPS
+
+┌────────────────────────────────────────────────────────────────────────────────────────────┐
+│  name  │ cpu_quota │ memory_quota │ query_timeout │ max_concurrency │ query_queued_timeout │
+│ String │   String  │    String    │     String    │      String     │        String        │
+├────────┼───────────┼──────────────┼───────────────┼─────────────────┼──────────────────────┤
+│ test   │ 30%       │              │ 15s           │                 │                      │
+└────────────────────────────────────────────────────────────────────────────────────────────┘
+```

docs/en/sql-reference/10-sql-commands/00-ddl/index.md

@@ -50,3 +50,4 @@ These topics provide reference information for the DDL (Data Definition Language
 ## Compute Resource Management
 
 - [Warehouse](19-warehouse/index.md)
+- [Workload Group](20-workload-group/index.md)