ALTER RESOURCE GROUP

ALTER RESOURCE GROUP

更改一个资源组的限制项。

语法

``` sql ALTER RESOURCE GROUP name SET group_attribute value

其中group_attribute关键字可为以下子句之一:

CONCURRENCY integer CPU_RATE_LIMIT integer CPU_RATE_CEILING integer CPUSET tuple MEMORY_LIMIT integer IO_KBPS integer IC_KBPS integer QUEUE_PRIORITY integer ```

描述

ALTER RESOURCE GROUP更改一个资源组的限制项。 只有超级用户才能修改资源组。

用户可以为控制角色最大活动并行度的资源组设置或者重置并行度的限制。用户还可以通过为资源组重置内存或者CPU资源来控制所有通过资源组提交的查询在每个Executor节点上可以使用的内存或CPU总量。

当用户更改资源组CPU资源的模式或者限制时，新的模式或限制会立即生效。

当用户更改为角色创建的资源组的内存限制时，如果当前资源使用率小于或等于新值且资源组中没有正在运行的事务，则会立即应用新的资源限制。

用户可以在单个 ALTER RESOURCE GROUP 调用中更改限制的类型。

参数

该SQL命令参数说明见下

参数的意义详见CREATE RESOURCE GROUP以及“资源管理”章节。

CPU_RATE_LIMIT integer，CPU_RATE_CEILING integer，CPUSET tuple

三个参数均与CPU资源限制有关。

注意

用 CREATE ROLE 或者 ALTER ROLE 来将一个指定资源组分配给角色（用户）。

用户不能在显式事务或者子事务中提交ALTER RESOURCE GROUP 命令。

示例

更改资源组的活动事务限制：

ALTER RESOURCE GROUP rgroup1 SET CONCURRENCY 13;

更新资源组的CPU相对使用率限制：

ALTER RESOURCE GROUP rgroup2 SET CPU_RATE_LIMIT 45;

更新资源组的内存限制：

ALTER RESOURCE GROUP rgroup3 SET MEMORY_LIMIT 300;

为资源组保留CPU核 1：

ALTER RESOURCE GROUP rgroup5 SET CPUSET '1';

兼容性说明

ALTER RESOURCE GROUP 语句是SeaboxMPP数据库的扩展，在PostgreSQL标准中没有该命令。

相关SQL命令

CREATE RESOURCE GROUP, DROP RESOURCE GROUP, CREATE ROLE, ALTER ROLE