📣

TiDB Cloud Serverless 现已更名为
Starter
!此页面由 AI 自动翻译,英文原文请见
此处。

ALTER RESOURCE GROUP

ALTER RESOURCE GROUP 语句用于修改数据库中的资源组。

语法

AlterResourceGroupStmt
ALTERRESOURCEGROUPIfExistsResourceGroupNameResourceGroupOptionList
IfExists
IFEXISTS
ResourceGroupName
IdentifierDEFAULT
ResourceGroupOptionList
DirectResourceGroupOptionResourceGroupOptionListDirectResourceGroupOptionResourceGroupOptionList,DirectResourceGroupOption
DirectResourceGroupOption
RU_PER_SECEqOptLengthNumPRIORITYEqOptResourceGroupPriorityOptionBURSTABLEBURSTABLEEqOptBooleanQUERY_LIMITEqOpt(ResourceGroupRunawayOptionList)QUERY_LIMITEqOpt()QUERY_LIMITEqOptNULLBACKGROUNDEqOpt(BackgroundOptionList)BACKGROUNDEqOpt()BACKGROUNDEqOptNULL
ResourceGroupPriorityOption
LOWMEDIUMHIGH
ResourceGroupRunawayOptionList
DirectResourceGroupRunawayOptionResourceGroupRunawayOptionListDirectResourceGroupRunawayOptionResourceGroupRunawayOptionList,DirectResourceGroupRunawayOption
DirectResourceGroupRunawayOption
EXEC_ELAPSEDEqOptstringLitPROCESSED_KEYSEqOptintLitRUEqOptintLitACTIONEqOptResourceGroupRunawayActionOptionWATCHEqOptResourceGroupRunawayWatchOptionDURATIONEqOptstringLit
ResourceGroupRunawayWatchOption
EXACTSIMILAR
ResourceGroupRunawayActionOption
DRYRUNCOOLDOWNKILLSWITCH_GROUP(ResourceGroupName)
BackgroundOptionList
DirectBackgroundOptionBackgroundOptionListDirectBackgroundOptionBackgroundOptionList,DirectBackgroundOption
DirectBackgroundOption
TASK_TYPESEqOptstringLitUTILIZATION_LIMITEqOptLengthNum

TiDB 支持以下 DirectResourceGroupOption,其中 请求单元(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%。

示例

创建名为 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 不同,因此两者不兼容。

另请参阅

文档内容是否有帮助?