# ALTER RESOURCE POOL #### 功能描述 修改一个资源池，指定其他控制组。 #### 注意事项 只要用户对当前数据库有ALTER权限，就可以修改资源池。 #### 语法格式 ``` 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}[, ... ]); ``` #### 参数说明 表1ALTER 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 | 异常规则集。 **异常规则集**是由一组定义了作业执行时间、作业排队时间、CPU使用率、最大落盘等各项规则阈值的集合，与资源池绑定搭配后使用，当用户执行作业时，触发了异常规则，则作业会选择终止或者降级。 了解更多，请参见[CREATE EXCEPT RULE](https://support.huaweicloud.com/sqlreference-dws/dws_06_0281.html)。 | - | | weight | 资源池网络带宽权重。 | - | | enable_concurrency_scaling | 弹性并发扩展功能开关。该功能仅9.1.0.100及以上集群版本支持。默认值为false。 | true或false。 - true，表示开启该资源池作业的弹性并发扩展功能。 - false，表示关闭该资源池作业的弹性并发扩展功能。 | ![](https://support.huaweicloud.com/sqlreference-dws/public_sys-resources/note_3.0-zh-cn.png) - 设置控制组名称"**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控制组。 ``` DROP RESOURCE POOL IF EXISTS pool_test; CREATE RESOURCE POOL pool_test; ``` 修改资源池pool_test，其控制组指定为"DefaultClass"组下属的"High"Timeshare Workload控制组。 ``` ALTER RESOURCE POOL pool_test WITH (CONTROL_GROUP="High"); ``` 关闭指定资源池作业的弹性并发扩展功能。 ``` ALTER RESOURCE POOL pool_test WITH (enable_concurrency_scaling=false); ``` #### 相关链接 [CREATE RESOURCE POOL](https://support.huaweicloud.com/sqlreference-dws/dws_06_0171.html)，[DROP RESOURCE POOL](https://support.huaweicloud.com/sqlreference-dws/dws_06_0202.html)