update alter resource group

pingcap · Sep 18, 2024 · 1a6ea99 · 1a6ea99
1 parent 9a0ab2a
commit 1a6ea99
Showing 1 changed file with 9 additions and 8 deletions.
diff --git a/sql-statements/sql-statement-alter-resource-group.md b/sql-statements/sql-statement-alter-resource-group.md
@@ -26,7 +26,7 @@ ResourceGroupOptionList ::=
 |   ResourceGroupOptionList ',' DirectResourceGroupOption
 
 DirectResourceGroupOption ::=
-    "RU_PER_SEC" EqOpt stringLit
+    "RU_PER_SEC" EqOpt LengthNum
 |   "PRIORITY" EqOpt ResourceGroupPriorityOption
 |   "BURSTABLE"
 |   "BURSTABLE" EqOpt Boolean
@@ -68,6 +68,7 @@ BackgroundOptionList ::=
 
 DirectBackgroundOption ::= 
     "TASK_TYPES" EqOpt stringLit
+|   "UTILIZATION_LIMIT" EqOpt LengthNum
 ```
 
 TiDB 支持以下 `DirectResourceGroupOption`, 其中 [Request Unit (RU)](/tidb-resource-control.md#什么是-request-unit-ru) 是 TiDB 对 CPU、IO 等系统资源统一抽象的单位。
@@ -78,7 +79,7 @@ TiDB 支持以下 `DirectResourceGroupOption`, 其中 [Request Unit (RU)](/tidb-
 | `PRIORITY`    | 任务在 TiKV 上处理的绝对优先级  | `PRIORITY = HIGH` 表示优先级高。若未指定则默认为 `MEDIUM`。 |
 | `BURSTABLE`   | 允许对应的资源组超出配额后使用空余的系统资源。 |
 | `QUERY_LIMIT` | 当查询执行满足该条件时，识别该查询为 Runaway Query 并执行相应的操作 | `QUERY_LIMIT=(EXEC_ELAPSED='60s', ACTION=KILL, WATCH=EXACT DURATION='10m')` 表示当执行时间超过 60 秒后识别为 Runaway Query，对该查询执行终止操作，并在 10 分钟内对同样的 SQL 直接执行终止操作。`QUERY_LIMIT=()` 或 `QUERY_LIMIT=NULL` 则表示不进行 Runaway 控制。具体参数介绍参见[管理资源消耗超出预期的查询 (Runaway Queries)](/tidb-resource-control.md#管理资源消耗超出预期的查询-runaway-queries)。 ｜
-| `BACKGROUND`  | 后台任务相关的设置。具体参数介绍参见[管理后台任务](/tidb-resource-control.md#管理后台任务) | `BACKGROUND=(TASK_TYPES="br,stats")` 表示将备份恢复和收集统计信息相关的任务作为后台任务调度。 |
+| `BACKGROUND`  | 后台任务相关的设置。具体参数介绍参见[管理后台任务](/tidb-resource-control.md#管理后台任务) | `BACKGROUND=(TASK_TYPES="br,stats", UTILIZATION_LIMIT=30)` 表示将备份恢复和收集统计信息相关的任务作为后台任务调度，并且后台任务最多可以使用 TiKV 30% 的资源。 |
 
 > **注意：**
 >
@@ -148,7 +149,7 @@ SELECT * FROM information_schema.resource_groups WHERE NAME ='rg1';
 修改 `default` 资源组的后台任务 `BACKGROUND` 相关设置。
 
 ```sql
-ALTER RESOURCE GROUP default BACKGROUND = (TASK_TYPES = "br,ddl");
+ALTER RESOURCE GROUP default BACKGROUND = (TASK_TYPES = "br,ddl", UTILIZATION_LIMIT=30);
 ```
 
 ```sql
@@ -160,11 +161,11 @@ SELECT * FROM information_schema.resource_groups WHERE NAME ='default';
 ```
 
 ```sql
-+---------+------------+----------+-----------+-------------+---------------------+
-| NAME    | RU_PER_SEC | PRIORITY | BURSTABLE | QUERY_LIMIT | BACKGROUND          |
-+---------+------------+----------+-----------+-------------+---------------------+
-| default | UNLIMITED  | MEDIUM   | YES       | NULL        | TASK_TYPES='br,ddl' |
-+---------+------------+----------+-----------+-------------+---------------------+
++---------+------------+----------+-----------+-------------+-------------------------------------------+
+| NAME    | RU_PER_SEC | PRIORITY | BURSTABLE | QUERY_LIMIT | BACKGROUND                                |
++---------+------------+----------+-----------+-------------+-------------------------------------------+
+| default | UNLIMITED  | MEDIUM   | YES       | NULL        | TASK_TYPES='br,ddl', UTILIZATION_LIMIT=30 |
++---------+------------+----------+-----------+-------------+-------------------------------------------+
 1 rows in set (1.30 sec)
 ```