更新时间:2024-09-02 GMT+08:00

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}[, ... ]);

参数说明

  • pool_name

    资源池名称。

    资源池名称为已创建的资源池。

    取值范围:字符串,要符合标识符的命名规范。

  • group_name

    控制组名称。

    • 设置控制组名称时,语法可以使用双引号,也可以使用单引号。
    • group_name对大小写敏感。
    • 不指定group_name时,默认指定的字符串为 "Medium",代表指定DefaultClass控制组的

      "Medium" Timeshare控制组。

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

    取值范围:已创建的控制组。

  • stmt

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

    取值范围:数值型,-1~INT_MAX。

  • dop

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

    取值范围:数值型,1~INT_MAX。

  • memory_size

    资源池最大使用内存。

    取值范围:字符串,内容范围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及以上集群版本支持。

    取值范围:

    • true表示开启该资源池作业的弹性并发扩展功能。
    • false表示关闭该资源池作业的弹性并发扩展功能。

    默认值:false

示例

修改一个资源池,其控制组指定为“DefaultClass”组下属的“High”Timeshare Workload控制组:

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

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

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