sql-statement-create-resource-group.md

title	summary
CREATE RESOURCE GROUP	TiDB 数据库中 CREATE RESOURCE GROUP 的使用概况。

CREATE RESOURCE GROUP

CREATE RESOURCE GROUP 语句用于在当前所选数据库中创建资源组。

语法图

CreateResourceGroupStmt:
   "CREATE" "RESOURCE" "GROUP" IfNotExists ResourceGroupName ResourceGroupOptionList

IfNotExists ::=
    ('IF' 'NOT' 'EXISTS')?

ResourceGroupName:
   Identifier

ResourceGroupOptionList:
    DirectResourceGroupOption
|   ResourceGroupOptionList DirectResourceGroupOption
|   ResourceGroupOptionList ',' DirectResourceGroupOption

DirectResourceGroupOption:
    "RU_PER_SEC" EqOpt stringLit
|   "BURSTABLE"

资源组的 ResourceGroupName 是全局唯一的，不允许重复。

TiDB 支持以下 DirectResourceGroupOption, 其中 Request Unit (RU) 是 TiDB 对 CPU、IO 等系统资源统一抽象的单位。

参数	含义	举例
RU_PER_SEC	每秒 RU 填充的速度	RU_PER_SEC = 500 表示此资源组每秒回填 500 个 RU

如果设置了 BURSTABLE 属性，TiDB 允许对应的资源组超出配额后使用空余的系统资源。

注意：

CREATE RESOURCE GROUP 语句只能在全局变量 tidb_enable_resource_control 参数设置为 ON 时才能执行。

示例

创建 rg1 和 rg2 两个资源组。

mysql> DROP RESOURCE GROUP IF EXISTS rg1;
Query OK, 0 rows affected (0.22 sec)
mysql> CREATE RESOURCE GROUP IF NOT EXISTS rg1
    ->  RU_PER_SEC = 100
    ->  BURSTABLE;
Query OK, 0 rows affected (0.08 sec)
mysql> CREATE RESOURCE GROUP IF NOT EXISTS rg2
    ->  RU_PER_SEC = 200;
Query OK, 0 rows affected (0.08 sec)
mysql> SELECT * FROM information_schema.resource_groups WHERE NAME ='rg1' or NAME = 'rg2';
+------+-------------+-----------+
| NAME | RU_PER_SEC  | BURSTABLE |
+------+-------------+-----------+
| rg1  |         100 | YES       |
| rg2  |         200 | NO        |
+------+-------------+-----------+
2 rows in set (1.30 sec)

MySQL 兼容性

MySQL 也支持 CREATE RESOURCE GROUP，但是接受的参数和 TiDB 不同，两者并不兼容。

另请参阅

• DROP RESOURCE GROUP
• ALTER RESOURCE GROUP
• RU