ALTER RESOURCE GROUP
ALTER RESOURCE GROUP 语句用于修改数据库中的资源组。
Note
该功能在 平凯数据库云服务 Starter 和 平凯数据库云服务 Essential 实例中不可用。
语法
- AlterResourceGroupStmt
- IfExists
- ResourceGroupName
- ResourceGroupOptionList
- DirectResourceGroupOption
- ResourceGroupPriorityOption
- ResourceGroupRunawayOptionList
- DirectResourceGroupRunawayOption
- ResourceGroupRunawayWatchOption
- ResourceGroupRunawayActionOption
- BackgroundOptionList
- DirectBackgroundOption
TiDB 支持以下 DirectResourceGroupOption，其中 Request Unit (RU) 是 TiDB 中对 CPU、IO 及其他系统资源的统一抽象单位。
| 选项 | 描述 | 示例 |
|---|---|---|
RU_PER_SEC | 每秒回填的 RU 速率 | RU_PER_SEC = 500 表示该资源组每秒回填 500 个 RU |
PRIORITY | 在 TiKV 上待处理任务的绝对优先级 | PRIORITY = HIGH 表示优先级为高。如果未指定，默认值为 MEDIUM。 |
BURSTABLE | 如果设置了 BURSTABLE 属性，TiDB 允许对应资源组在超出配额时使用可用的系统资源。 | |
QUERY_LIMIT | 当查询执行满足该条件时，查询会被识别为异常查询并执行相应操作。 | QUERY_LIMIT=(EXEC_ELAPSED='60s', ACTION=KILL, WATCH=EXACT DURATION='10m') 表示当查询执行时间超过 60 秒时被识别为异常查询，并被终止。所有 SQL 文本相同的 SQL 语句将在接下来的 10 分钟内被立即终止。QUERY_LIMIT=() 或 QUERY_LIMIT=NULL 表示未启用异常查询控制。详见 异常查询。 |
BACKGROUND | 配置后台任务。更多详情参见 管理后台任务。 | BACKGROUND=(TASK_TYPES="br,stats", UTILIZATION_LIMIT=30) 表示备份恢复和统计信息收集相关任务被调度为后台任务，且后台任务最多可消耗 TiKV 资源的 30%。 |
Note
- 只有当全局变量
tidb_enable_resource_control设置为ON时，才能执行ALTER RESOURCE GROUP语句。ALTER RESOURCE GROUP语句支持增量变更，未指定的参数保持不变。但QUERY_LIMIT和BACKGROUND作为整体使用，不能部分修改。- 目前，仅
default资源组支持修改BACKGROUND配置。
示例
创建名为 rg1 的资源组并修改其属性。
DROP RESOURCE GROUP IF EXISTS rg1;Query OK, 0 rows affected (0.22 sec)CREATE RESOURCE GROUP IF NOT EXISTS rg1
RU_PER_SEC = 100
BURSTABLE;Query OK, 0 rows affected (0.08 sec)SELECT * FROM information_schema.resource_groups WHERE NAME ='rg1';+------+------------+----------+-----------+-------------+------------+
| NAME | RU_PER_SEC | PRIORITY | BURSTABLE | QUERY_LIMIT | BACKGROUND |
+------+------------+----------+-----------+-------------+------------+
| rg1 | 100 | MEDIUM | NO | NULL | NULL |
+------+------------+----------+-----------+-------------+------------+
1 rows in set (1.30 sec)ALTER RESOURCE GROUP rg1
RU_PER_SEC = 200
PRIORITY = LOW
QUERY_LIMIT = (EXEC_ELAPSED='1s' ACTION=COOLDOWN WATCH=EXACT DURATION '30s');Query OK, 0 rows affected (0.08 sec)SELECT * FROM information_schema.resource_groups WHERE NAME ='rg1';+------+------------+----------+-----------+----------------------------------------------------------------+------------+
| NAME | RU_PER_SEC | PRIORITY | BURSTABLE | QUERY_LIMIT | BACKGROUND |
+------+------------+----------+-----------+----------------------------------------------------------------+------------+
| rg1 | 200 | LOW | NO | EXEC_ELAPSED='1s', ACTION=COOLDOWN, WATCH=EXACT DURATION='30s' | NULL |
+------+------------+----------+-----------+----------------------------------------------------------------+------------+
1 rows in set (1.30 sec)修改 default 资源组的 BACKGROUND 选项。
ALTER RESOURCE GROUP default BACKGROUND = (TASK_TYPES = "br,ddl", UTILIZATION_LIMIT=30);Query OK, 0 rows affected (0.08 sec)SELECT * FROM information_schema.resource_groups WHERE NAME ='default';+---------+------------+----------+-----------+-------------+-------------------------------------------+
| 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)MySQL 兼容性
MySQL 也支持 ALTER RESOURCE GROUP。但其可接受的参数与 TiDB 不同，因此两者不兼容。