华为云首页用户手册

云数据库 TAURUSDB-多租户管理与资源隔离:资源计划指令(plan_directive)管理

时间：2025-01-10 14:24:38

云数据库 TAURUSDB

资源计划指令(plan_directive)管理

资源计划指令描述了一个资源消费组具体的资源配置情况，一个资源计划指令唯一对应一个资源消费组；一个资源消费组可以关联多个资源计划指令，其中至多只允许启用一个资源计划指令，启用资源计划指令由上述启用资源计划实现。

创建资源计划指令
```
dbms_resource_manager.create_plan_directive (
   plan                    CHAR(128), 
   group_or_subplan        CHAR(128), 
   comment                 VARCHAR(2000), 
   mgmt_p1                 bigint(20),
   utilization_limit       bigint(20));
```
- plan：资源计划(plan)的名称。
- group_or_subplan：资源消费组(consumer_group)的名称。
- comment：资源计划指令的描述信息，可为''。
- mgmt_p1：在CPU资源争抢的情况下，承诺分配给本资源消费组的CPU资源占所属租户总CPU资源的比例，取值范围[0, 100]，表示使用所属租户100%的CPU。同一租户且同一个资源计划(plan)所关联的所有资源计划指令(plan_directive)的mgmt_p1总和不超过100。当租户内的各个资源消费组发生CPU争抢，优先保证承诺分配各个资源消费组CPU资源，剩余的CPU资源由各个资源消费组争抢。承诺分配给资源消费组的CPU资源也遵循按需分配策略，不会预留，例如：承诺给当前资源消费组20%的CPU资源，但当前资源消费组业务量较少，只需要5%的CPU资源，则剩余的15%的CPU资源会按需分配给其他资源消费组。
- utilization_limit：资源消费组可用的CPU资源的上限占所属租户总CPU资源的比例，取值范围为 [1, 100]。表示最大可使用租户全部CPU资源，如果取值为70则表示最大可使用租户70%的CPU资源。
- 同一资源消费组下的用户共享当前启用的资源计划指令配置的资源。例如：同一租户下的用户user1和user2都添加到资源消费组consumer_group1中，consumer_group1当前启用的资源计划指令的UTILIZATION_LIMIT为70，mgmt_p1为10，则user1和user2可使用的CPU资源总和最大为当前租户70%，CPU争抢时，保证user1和user2可获得的CPU资源总和为当前租户10%。

更新资源计划指令
```
dbms_resource_manager.update_plan_directive (
   plan                    CHAR(128), 
   group_or_subplan        CHAR(128), 
   new_comment             VARCHAR(2000), 
   new_mgmt_p1             bigint(20),
   new_utilization_limit   bigint(20));
```
- plan：资源计划(plan)的名称。
- group_or_subplan：资源消费组(consumer_group)的名称。
- comment：资源计划指令的描述信息，可为''。
- mgmt_p1：在CPU资源争抢的情况下，承诺分配给本资源消费组的CPU资源占所属租户总CPU资源的比例，取值范围[0, 100]，表示使用所属租户100%的CPU。同一租户且同一个资源计划(plan)所关联的所有资源计划指令(plan_directive)的mgmt_p1总和不超过100。当租户内的各个资源消费组发生CPU争抢，优先保证承诺分配各个资源消费组CPU资源，剩余的CPU资源由各个资源消费组争抢。承诺分配给资源消费组的CPU资源也遵循按需分配策略，不会预留，例如：承诺给当前资源消费组20%的CPU资源，但当前资源消费组业务量较少，只需要5%的CPU资源，则剩余的15%的CPU资源会按需分配给其他资源消费组。
- utilization_limit：资源消费组可用的CPU资源的上限占所属租户总CPU资源的比例，取值范围为 [1, 100]。表示最大可使用租户全部CPU资源，如果取值为70则表示最大可使用租户 70%的CPU资源。
- 同一资源消费组下的用户共享当前启用的资源计划指令配置的资源。例如：同一租户下的用户user1和user2都添加到资源消费组consumer_group1中，consumer_group1当前启用的资源计划指令的UTILIZATION_LIMIT为70，mgmt_p1为10，则user1和user2可使用的CPU资源总和最大为当前租户70%，CPU争抢时，保证user1和user2可获得的CPU资源总和为当前租户10%。

删除资源计划指令
```
dbms_resource_manager.delete_plan_directive (
    plan                   CHAR(128), 
    group_or_subplan       VARCHAR(128));
```
- plan：资源计划(plan)的名称。
- group_or_subplan：资源消费组(consumer_group)的名称。
- 删除正在启用的plan_directive, 将导致对应用户的资源配置失效。

查看资源计划指令
DBA_RSRC_PLAN_DIRECTIVES记录资源计划指令的详细信息。如果在系统租户下查看，则可以查询到所有租户的资源计划指令，如果在普通租户下查看，只能看到当前租户下的资源计划指令。
```
SELECT * FROM information_schema.DBA_RSRC_PLAN_DIRECTIVES;
```

上一篇：云数据库 TAURUSDB-多租户管理与资源隔离:CPU使用率统计

下一篇：云数据库 TAURUSDB-多租户管理与资源隔离:CPU使用率统计