文档首页/数据仓库服务 DWS/更多文档/语法参考（阿布扎比区域）/DDL语法/ALTER RESOURCE POOL
更新时间：2025-10-11 GMT+08:00
查看PDF
分享

ALTER RESOURCE POOL

功能描述

修改一个资源池，指定其他控制组。

注意事项

只要用户对当前数据库有ALTER权限，就可以修改资源池。

语法格式

1
2
ALTER RESOURCE POOL pool_name
    WITH ({MEM_PERCENT=pct | CONTROL_GROUP='group_name' | ACTIVE_STATEMENTS=stmt | MAX_DOP = dop | MEMORY_LIMIT='memory_size' | io_limits=io_limits | io_priority='priority' | nodegroup='nodegroup_name' | except_rule='except_rule' | weight=bandwidth_weight | enable_concurrency_scaling=boolean}[, ... ]);

参数说明

表1 ALTER RESOURCE POOL参数说明

参数

描述

取值范围

pool_name

需要修改的资源池名称。

已存在的资源池。

group_name

控制组名称。

已存在的控制组。

stmt

资源池语句执行的最大并发数量。

数值型，-1~INT_MAX。

dop

资源池简单语句执行的最大并发数量。

数值型，1~INT_MAX。

memory_size

使用该资源池的作业估算内存上限。

取值范围：字符串

  • default，表示最大为资源池内存一半。
  • unlimited，表示不限制。
  • 数值范围为1KB~2047GB。

mem_percent

资源池可用内存占全部内存或者组用户内存使用的比例。

普通用户的mem_percent范围为0-100的整数，默认值为0。

io_limits

该参数8.1.2集群版本中已废弃，为兼容历史版本保留该参数。

-

io_priority

该参数8.1.2集群版本中已废弃，为兼容历史版本保留该参数。

-

except_rule

异常规则集。

-

weight

资源池网络带宽权重。

-

enable_concurrency_scaling

弹性并发扩展功能开关。该功能仅9.1.0.100及以上集群版本支持。默认值为false。

true或false。

  • true，表示开启该资源池作业的弹性并发扩展功能。
  • false，表示关闭该资源池作业的弹性并发扩展功能。
  • 设置控制组名称“group_name”时，语法可以使用双引号，也可以使用单引号。
  • group_name对大小写敏感。
  • 不指定group_name时，默认指定的字符串为 "Medium"，代表指定DefaultClass控制组的

    "Medium" Timeshare控制组。

  • 若数据库用户指定Timeshare控制组代表的字符串，即"Rush"、"High"、"Medium"或"Low"其中一种，如control_group的字符串为"High"；代表资源池指定到DefaultClass控制组下的"High" Timeshare控制组。

示例

创建示例资源池pool_test，其控制组为“DefaultClass”组下属的“Medium”Timeshare Workload控制组。

1
2
DROP RESOURCE POOL IF EXISTS pool_test;
CREATE RESOURCE POOL pool_test;

修改资源池pool_test，其控制组指定为“DefaultClass”组下属的“High”Timeshare Workload控制组。

1
ALTER RESOURCE POOL pool_test WITH (CONTROL_GROUP="High");

关闭指定资源池作业的弹性并发扩展功能。

1
ALTER RESOURCE POOL pool_test WITH (enable_concurrency_scaling=false);

相关链接

CREATE RESOURCE POOL，DROP RESOURCE POOL

父主题： DDL语法