配置 SQL 级资源隔离(MySQL 模式)
MySQL 模式下 SQL 级资源隔离的配置方法。
磁盘性能校准
在控制 IOPS 资源隔离前，需要进行磁盘性能校准。
连接集群
使用 root 用户登录 obcluster 集群的 sys 租户。
obclient -h127.0.0.1 -P2883 -uroot@sys#obcluster -A
对集群内的所有 Zone 触发磁盘校准任务
根据业务使用场景，选择合适的命令，触发磁盘校准任务。对集群内的所有 Zone 触发磁盘校准任务。
ALTER SYSTEM RUN JOB "io_calibration" ZONE = zone1;
ALTER SYSTEM RUN JOB "io_calibration" ZONE = zone2;
ALTER SYSTEM RUN JOB "io_calibration" ZONE = zone3;
查看磁盘 I/O 校准状态
触发磁盘校准任务后，您可以通过 GV$OB_IO_CALIBRATION_STATUS 或 V$OB_IO_CALIBRATION_STATUS 视图确认 I/O 校准状态。
SELECT * FROM oceanbase.V$OB_IO_CALIBRATION_STATUS;
输出结果如下：
obclient(root@sys)[(none)]> SELECT * FROM oceanbase.V$OB_IO_CALIBRATION_STATUS;
+--------------+----------+--------------+-------------+----------------------------+-------------+
| SVR_IP | SVR_PORT | STORAGE_NAME | STATUS | START_TIME | FINISH_TIME |
+--------------+----------+--------------+-------------+----------------------------+-------------+
| 10.43.231.92 | 2882 | DATA | IN PROGRESS | 2025-09-22 11:43:07.955839 | NULL |
+--------------+----------+--------------+-------------+----------------------------+-------------+
1 row in set (0.047 sec)
磁盘 I/O 校准状态分为以下几种：
-
NOT AVAILABLE：表示未开始 I/O 校准。 -
IN PROGRESS：表示正在进行 I/O 校准。 -
READY：表示 I/O 校准已完成。 -
FAILED：表示 I/O 校准执行失败。
从查询结果可知，STATUS 字段的值为 IN PROGRESS ，表示正在进行磁盘 I/O 校准。待磁盘 I/O 校准完成后，STATUS 字段的值会变成 READY ，表示磁盘校准已完成，同时 FINISH_TIME 字段中会显示完成时间。
确认磁盘 I/O 校准是否生效
待磁盘 I/O 校准完成后，通过 V$OB_IO_BENCHMARK 视图确认磁盘 I/O 校准是否生效。
SELECT * FROM oceanbase.V$OB_IO_BENCHMARK;
输出结果如下：
obclient(root@sys)[(none)]> SELECT * FROM oceanbase.V$OB_IO_BENCHMARK;
+--------------+----------+--------------+-------+---------+-------+------+---------+
| SVR_IP | SVR_PORT | STORAGE_NAME | MODE | SIZE | IOPS | MBPS | LATENCY |
+--------------+----------+--------------+-------+---------+-------+------+---------+
| 10.43.139.79 | 2882 | DATA | READ | 4096 | 64507 | 251 | 248 |
| 10.43.139.79 | 2882 | DATA | READ | 8192 | 65016 | 507 | 249 |
| 10.43.139.79 | 2882 | DATA | READ | 16384 | 58495 | 913 | 274 |
| 10.43.139.79 | 2882 | DATA | READ | 32768 | 51000 | 1593 | 313 |
| 10.43.139.79 | 2882 | DATA | READ | 65536 | 27577 | 1723 | 581 |
| 10.43.139.79 | 2882 | DATA | READ | 131072 | 13941 | 1742 | 1150 |
| 10.43.139.79 | 2882 | DATA | READ | 262144 | 7584 | 1896 | 2119 |
| 10.43.139.79 | 2882 | DATA | READ | 524288 | 3997 | 1998 | 4019 |
| 10.43.139.79 | 2882 | DATA | READ | 1048576 | 1980 | 1980 | 8152 |
| 10.43.139.79 | 2882 | DATA | READ | 2097152 | 714 | 1428 | 22442 |
| 10.43.139.79 | 2882 | DATA | WRITE | 4096 | 8242 | 32 | 1944 |
| 10.43.139.79 | 2882 | DATA | WRITE | 8192 | 6908 | 53 | 2318 |
| 10.43.139.79 | 2882 | DATA | WRITE | 16384 | 5249 | 82 | 3049 |
| 10.43.139.79 | 2882 | DATA | WRITE | 32768 | 2212 | 69 | 7240 |
| 10.43.139.79 | 2882 | DATA | WRITE | 65536 | 1222 | 76 | 13105 |
| 10.43.139.79 | 2882 | DATA | WRITE | 131072 | 637 | 79 | 25211 |
| 10.43.139.79 | 2882 | DATA | WRITE | 262144 | 320 | 80 | 50309 |
| 10.43.139.79 | 2882 | DATA | WRITE | 524288 | 176 | 88 | 91490 |
| 10.43.139.79 | 2882 | DATA | WRITE | 1048576 | 78 | 78 | 164405 |
| 10.43.139.79 | 2882 | DATA | WRITE | 2097152 | 10 | 20 | 219297 |
+--------------+----------+--------------+-------+---------+-------+------+---------+
20 rows in set (0.015 sec)
将租户的 MAX_IOPS 和 MIN_IOPS 配置为有效值
说明：如果在创建租户所使用的 Unit 规格时，已将 MAX_IOPS 和 MIN_IOPS 设置为 16 KB 读对应的 IOPS 值，或者不需要控制 IOPS 的资源隔离，请忽略本步骤。
完成磁盘校准后，在配置资源隔离计划前，需要保证租户的资源规格中 MAX_IOPS 和 MIN_IOPS 的值为有效值，这里的有效值指的是以 16 KB 读对应的 IOPS 值作为租户 IOPS 配置的参考值。
查看待进行资源隔离的租户的资源规格
执行以下命令，查看待进行资源隔离的租户的资源规格。
SELECT * FROM oceanbase.DBA_OB_UNIT_CONFIGS;
输出结果如下：
obclient(root@sys)[(none)]> SELECT * FROM oceanbase.DBA_OB_UNIT_CONFIGS;
+----------------+-------------------+----------------------------+----------------------------+---------+---------+-------------+---------------+---------------------+---------------------+-------------+
| UNIT_CONFIG_ID | NAME | CREATE_TIME | MODIFY_TIME | MAX_CPU | MIN_CPU | MEMORY_SIZE | LOG_DISK_SIZE | MAX_IOPS | MIN_IOPS | IOPS_WEIGHT |
+----------------+-------------------+----------------------------+----------------------------+---------+---------+-------------+---------------+---------------------+---------------------+-------------+
| 1 | sys_unit_config | 2025-06-16 17:12:20.916675 | 2025-06-16 17:12:20.916675 | 3 | 3 | 2147483648 | 2147483648 | 9223372036854775807 | 9223372036854775807 | 3 |
| 1004 | mysql_tenant_unit | 2025-06-17 19:03:57.866709 | 2025-06-17 19:03:57.866709 | 1 | 1 | 2147483648 | 6442450944 | 10000 | 10000 | 1 |
+----------------+-------------------+----------------------------+----------------------------+---------+---------+-------------+---------------+---------------------+---------------------+-------------+
2 rows in set (0.119 sec)
根据查询结果，如果该租户的 MAX_IOPS 和 MIN_IOPS 均为默认值 INT64_MAX （9223372036854775807），则需要对租户可使用的 IOPS 资源重新进行规划。
查看租户id
use oceanbase
select * from dba_ob_tenants ;
输出信息如下：
obclient(root@sys)[oceanbase]> select * from dba_ob_tenants ;
+-----------+--------------+-------------+----------------------------+----------------------------+-------------------+---------------------------------------------+-------------------+--------------------+--------+---------------+--------+-------------+-------------------+------------------+---------------------+---------------------+---------------------+---------------------+--------------+----------------------------+----------+------------+-----------+
| TENANT_ID | TENANT_NAME | TENANT_TYPE | CREATE_TIME | MODIFY_TIME | PRIMARY_ZONE | LOCALITY | PREVIOUS_LOCALITY | COMPATIBILITY_MODE | STATUS | IN_RECYCLEBIN | LOCKED | TENANT_ROLE | SWITCHOVER_STATUS | SWITCHOVER_EPOCH | SYNC_SCN | REPLAYABLE_SCN | READABLE_SCN | RECOVERY_UNTIL_SCN | LOG_MODE | ARBITRATION_SERVICE_STATUS | UNIT_NUM | COMPATIBLE | MAX_LS_ID |
+-----------+--------------+-------------+----------------------------+----------------------------+-------------------+---------------------------------------------+-------------------+--------------------+--------+---------------+--------+-------------+-------------------+------------------+---------------------+---------------------+---------------------+---------------------+--------------+----------------------------+----------+------------+-----------+
| 1 | sys | SYS | 2025-06-16 17:12:20.944405 | 2025-06-16 17:12:20.944405 | RANDOM | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 | NULL | MYSQL | NORMAL | NO | NO | PRIMARY | NORMAL | 0 | NULL | NULL | NULL | NULL | NOARCHIVELOG | DISABLED | 1 | 4.3.1.0 | 1 |
| 1003 | META$1004 | META | 2025-06-17 19:05:09.070275 | 2025-06-17 19:05:43.178280 | zone1,zone2,zone3 | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 | NULL | MYSQL | NORMAL | NO | NO | PRIMARY | NORMAL | 0 | NULL | NULL | NULL | NULL | NOARCHIVELOG | DISABLED | 1 | 4.3.1.0 | 1 |
| 1004 | mysql_tenant | USER | 2025-06-17 19:05:09.076734 | 2025-06-17 19:05:43.282319 | zone1,zone2,zone3 | FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3 | NULL | MYSQL | NORMAL | NO | NO | PRIMARY | NORMAL | 0 | 1758512893619004002 | 1758512893619004002 | 1758512893619004002 | 4611686018427387903 | NOARCHIVELOG | DISABLED | 1 | 4.3.1.0 | 1003 |
+-----------+--------------+-------------+----------------------------+----------------------------+-------------------+---------------------------------------------+-------------------+--------------------+--------+---------------+--------+-------------+-------------------+------------------+---------------------+---------------------+---------------------+---------------------+--------------+----------------------------+----------+------------+-----------+
3 rows in set (0.060 sec)
确认租户部署在哪些 OBServer 节点上
执行以下命令，确认租户部署在哪些 OBServer 节点上。
SELECT DISTINCT SVR_IP, SVR_PORT FROM oceanbase.CDB_OB_LS_LOCATIONS WHERE tenant_id = 1004;
输出结果如下：
obclient(root@sys)[oceanbase]> SELECT DISTINCT SVR_IP, SVR_PORT FROM oceanbase.CDB_OB_LS_LOCATIONS WHERE tenant_id = 1004;
+--------------+----------+
| SVR_IP | SVR_PORT |
+--------------+----------+
| 10.43.139.79 | 2882 |
| 10.43.231.92 | 2882 |
| 10.43.51.60 | 2882 |
+--------------+----------+
3 rows in set (0.007 sec)
确认待进行资源隔离的租户所在的 OBServer 节点上的磁盘校准值
执行以下命令，确认待进行资源隔离的租户所在的 OBServer 节点上的磁盘校准值，使用 16 KB 读的磁盘校准值作为该节点 IOPS 设置的上限值。
SELECT * FROM oceanbase.GV$OB_IO_BENCHMARK WHERE MODE='READ' AND SIZE=16384;
输出结果如下：
obclient(root@sys)[oceanbase]> SELECT * FROM oceanbase.GV$OB_IO_BENCHMARK WHERE MODE='READ' AND SIZE=16384;
+--------------+----------+--------------+------+-------+-------+------+---------+
| SVR_IP | SVR_PORT | STORAGE_NAME | MODE | SIZE | IOPS | MBPS | LATENCY |
+--------------+----------+--------------+------+-------+-------+------+---------+
| 10.43.139.79 | 2882 | DATA | READ | 16384 | 49456 | 772 | 329 |
| 10.43.51.60 | 2882 | DATA | READ | 16384 | 48950 | 764 | 326 |
| 10.43.231.92 | 2882 | DATA | READ | 16384 | 50471 | 788 | 319 |
+--------------+----------+--------------+------+-------+-------+------+---------+
3 rows in set (0.010 sec)
根据查询结果，将获取到的各节点的磁盘校准值作为上限值来规划租户可用的 IOPS。由于集群内可能有多个租户部署在相同的 OBServer 节点，可以需要根据业务实际情况来分配这些 IOPS。
假设某集群下有两个租户，且两个租户都部署在相同的 OBServer 节点上，每个 OBServer 节点的 16 KB 读的磁盘 IOPS 基准值均相同，为 20000 IOPS，同时，预计两个租户的负载差不多，则可以将 20000 IOPS 平分给两个租户（具体可根据实际业务情况来为租户划分可用的 IOPS），即每个租户的 MAX_IOPS 和 MIN_IOPS 均配置为 10000，您也可以根据业务考虑，将 MIN_IOPS 设置为小于 MAX_IOPS 的某个值。
查询当前 MySQL 租户对应的 Unit
SELECT a.UNIT_CONFIG_ID, a.NAME AS UNIT_NAME, b.NAME AS POOL_NAME FROM oceanbase.DBA_OB_UNIT_CONFIGS a,oceanbase.DBA_OB_RESOURCE_POOLS b WHERE b.UNIT_CONFIG_ID=a.UNIT_CONFIG_ID;
输出结果如下：
obclient(root@sys)[oceanbase]> SELECT a.UNIT_CONFIG_ID, a.NAME AS UNIT_NAME, b.NAME AS POOL_NAME FROM oceanbase.DBA_OB_UNIT_CONFIGS a,oceanbase.DBA_OB_RESOURCE_POOLS b WHERE b.UNIT_CONFIG_ID=a.UNIT_CONFIG_ID;
+----------------+-------------------+-------------------+
| UNIT_CONFIG_ID | UNIT_NAME | POOL_NAME |
+----------------+-------------------+-------------------+
| 1 | sys_unit_config | sys_pool |
| 1004 | mysql_tenant_unit | mysql_tenant_pool |
+----------------+-------------------+-------------------+
2 rows in set (0.005 sec)
修改租户的 MAX_IOPS 和 MIN_IOPS 值
ALTER RESOURCE UNIT mysql_tenant_unit MAX_IOPS = 35000;
ALTER RESOURCE UNIT mysql_tenant_unit MIN_IOPS = 30000;
结束后， 执行 exit 退出数据库。
配置资源隔离计划
将不同的 SQL 条件分别绑定在 interactive_group 和 batch_group 2 个资源组上，再通过资源管理计划 daytime 来控制不同的 SQL 语句使用不同的 CPU 资源和 IOPS 资源。
连接集群
使用 root 用户登录 obcluster 集群的 mysql_tenant 租户。
obclient -h127.0.0.1 -P2883 -uroot@mysql_tenant#obcluster -Doceanbase -A
创建资源隔离所需的 2 个资源组
调用 DBMS_RESOURCE_MANAGER 系统包中的 CREATE_CONSUMER_GROUP 子程序创建资源隔离所需的 2 个资源组。
CALL DBMS_RESOURCE_MANAGER.CREATE_CONSUMER_GROUP(
CONSUMER_GROUP => 'interactive_group' ,
COMMENT => 'TP'
);
CALL DBMS_RESOURCE_MANAGER.CREATE_CONSUMER_GROUP(
CONSUMER_GROUP => 'batch_group' ,
COMMENT => 'AP'
);
参数说明如下：
-
CONSUMER_GROUP：定义资源组名称。 -
COMMENT：填写资源组的备注信息。
创建成功后，可以查询 DBA_RSRC_CONSUMER_GROUPS 视图进行确认。
SELECT * FROM oceanbase.DBA_RSRC_CONSUMER_GROUPS;
输出结果如下：
obclient(root@mysql_tenant)[oceanbase]> SELECT * FROM oceanbase.DBA_RSRC_CONSUMER_GROUPS;
+-------------------+-------------------+------------+-------------+--------------+----------+----------+--------+-----------+
| CONSUMER_GROUP_ID | CONSUMER_GROUP | CPU_METHOD | MGMT_METHOD | INTERNAL_USE | COMMENTS | CATEGORY | STATUS | MANDATORY |
+-------------------+-------------------+------------+-------------+--------------+----------+----------+--------+-----------+
| 10001 | batch_group | NULL | NULL | NULL | AP | NULL | NULL | NULL |
| 10000 | interactive_group | NULL | NULL | NULL | TP | NULL | NULL | NULL |
+-------------------+-------------------+------------+-------------+--------------+----------+----------+--------+-----------+
2 rows in set (0.011 sec)
创建资源管理计划
调用 DBMS_RESOURCE_MANAGER 系统包中的 CREATE_PLAN 子程序，创建一个名为 daytime 的资源管理计划，并添加备注信息。
CALL DBMS_RESOURCE_MANAGER.CREATE_PLAN(
PLAN => 'daytime',
comment => 'TPFirst');
参数说明如下：
-
PLAN：定义资源管理计划名称。 -
COMMENT：填写资源管理计划的备注信息。
创建成功后，可以查询 DBA_RSRC_PLANS 视图进行确认。
SELECT * FROM oceanbase.DBA_RSRC_PLANS;
输出结果如下：
obclient(root@mysql_tenant)[oceanbase]> SELECT * FROM oceanbase.DBA_RSRC_PLANS;
+---------+---------+---------------------+------------+-------------+----------------------+---------------------------+-------------+----------+----------+--------+-----------+
| PLAN_ID | PLAN | NUM_PLAN_DIRECTIVES | CPU_METHOD | MGMT_METHOD | ACTIVE_SESS_POOL_MTH | PARALLEL_DEGREE_LIMIT_MTH | QUEUING_MTH | SUB_PLAN | COMMENTS | STATUS | MANDATORY |
+---------+---------+---------------------+------------+-------------+----------------------+---------------------------+-------------+----------+----------+--------+-----------+
| NULL | daytime | NULL | NULL | NULL | NULL | NULL | NULL | NULL | TPFirst | NULL | NULL |
+---------+---------+---------------------+------------+-------------+----------------------+---------------------------+-------------+----------+----------+--------+-----------+
1 row in set (0.001 sec)
创建资源管理计划对应的资源管理计划内容
调用 DBMS_RESOURCE_MANAGER 系统包中的 CREATE_PLAN_DIRECTIVE 子程序，创建资源管理计划对应的资源管理计划内容，用于启用资源管理计划时，限制资源组所使用的 CPU 资源和 IOPS 资源。
- 指定资源计划为
daytime，绑定资源组interactive_group，并指定可使用的 CPU 资源上限为租户 CPU 总资源的 80%。同时，当出现出现 IO 争用时，指定最少可用的 IOPS 资源为 30%，可使用的 IOPS 资源上限为 IOPS 总资源为 90%，IOPS 资源权重为 80。
CALL DBMS_RESOURCE_MANAGER.CREATE_PLAN_DIRECTIVE(
PLAN => 'daytime',
GROUP_OR_SUBPLAN => 'interactive_group' ,
COMMENT => '',
UTILIZATION_LIMIT =>80,
MIN_IOPS => 30,
MAX_IOPS => 90,
WEIGHT_IOPS => 80);
- 指定资源计划为
daytime，绑定资源组batch_group，并指定可使用的 CPU 资源上限为租户 CPU 总资源的 40%。同时，当出现出现 IO 争用时，指定最少可用的 IOPS 资源为 40%，可使用的 IOPS 资源上限为 IOPS 总资源为 80%，IOPS 资源权重为 70。
CALL DBMS_RESOURCE_MANAGER.CREATE_PLAN_DIRECTIVE(
PLAN => 'daytime',
GROUP_OR_SUBPLAN => 'batch_group' ,
COMMENT => '',
UTILIZATION_LIMIT => 40,
MIN_IOPS => 40,
MAX_IOPS => 80,
WEIGHT_IOPS => 70);
参数说明如下：
-
PLAN：指定该资源管理计划内容所关联的资源管理计划名。 -
GROUP_OR_SUBPLAN：指定资源组。 -
COMMENT：填写资源管理计划内容的备注信息，默认值为NULL。 -
MGMT_P1：指定系统满负载情况下，承诺分配给本资源组的 CPU 占比。默认值为100。 -
UTILIZATION_LIMIT：指定资源组使用的 CPU 资源的上限。该参数的默认值为100，取值范围为 [0, 100]。100表示最大可使用租户全部 CPU 资源。如果取值为40则表示最大可使用租户 40% 的 CPU 资源。 -
MIN_IOPS：用于出现 IO 争用时，资源组预留的 IOPS 资源，总和不超过 100，默认值为0。 -
MAX_IOPS：用于指定资源组最大可使用的 IOPS 资源，总和可以超过 100，默认值为100。 -
WEIGHT_IOPS：用于指定 IOPS 的权重值，总和可以超过100，默认值为0。
创建成功，可以查询 DBA_OB_RSRC_IO_DIRECTIVES 视图进行确认。
SELECT * FROM oceanbase.DBA_OB_RSRC_IO_DIRECTIVES;
输出结果如下：
obclient(root@mysql_tenant)[oceanbase]> SELECT * FROM oceanbase.DBA_OB_RSRC_IO_DIRECTIVES;
+---------+-------------------+----------+----------+----------+-------------+
| PLAN | GROUP_OR_SUBPLAN | COMMENTS | MIN_IOPS | MAX_IOPS | WEIGHT_IOPS |
+---------+-------------------+----------+----------+----------+-------------+
| daytime | batch_group | | 40 | 80 | 70 |
| daytime | interactive_group | | 30 | 90 | 80 |
+---------+-------------------+----------+----------+----------+-------------+
2 rows in set (0.009 sec)
创建 SQL 资源隔离匹配规则
调用 DBMS_RESOURCE_MANAGER 系统包中的 SET_CONSUMER_GROUP_MAPPING 子程序。
- 指定当用户执行的一条 WHERE 条件中包含
test.t1.c3 = 3的 SQL 语句时，该 SQL 语句绑定到名为batch_group的资源组上执行，并使用该资源组所限制的 CPU 资源和 IOPS 资源。
CALL DBMS_RESOURCE_MANAGER.SET_CONSUMER_GROUP_MAPPING(
ATTRIBUTE => 'column',
VALUE => 'test.t1.c3=3',
CONSUMER_GROUP => 'batch_group');
- 指定当执行的一条 WHERE 条件中包含
t1.c3=5的 SQL 语句时，该 SQL 语句绑定到名为interactive_group的资源组上执行，并使用该资源组所限制的 CPU 资源和 IOPS 资源。
CALL DBMS_RESOURCE_MANAGER.SET_CONSUMER_GROUP_MAPPING(
ATTRIBUTE => 'column',
VALUE => 'test.t1.c3=5',
CONSUMER_GROUP => 'interactive_group');
参数说明如下：
-
ATTRIBUTE：指定属性类型，column表示 SQL 级资源隔离，user表示用户级 user 资源隔离，function表示用户级 function 资源隔离，属性名称不区分大小写。 -
VALUE：指定属性值，包括库名、表名、列名、常量值和用户名等信息。- 库名和用户名为可选，默认库名为当前库名，如果未指定用户名，则对所有用户生效，包括当前租户中后续新建的用户。
- 表名、列名、常量值为必选项，并且每项只能指定一个值。在指定常量值时，仅支持指定为数值或字符串。
- 在指定表名、列名、用户名时，指定的表、列和用户必须存在。
为资源组启用合适的资源管理计划
由于不同的资源管理计划中，同一个资源组被限制的资源可能不同。您需要为资源组启用合适的资源管理计划。
SET GLOBAL resource_manager_plan = 'daytime';
说明：如果不需要对资源进行限制，可以使用 ALTER SYSTEM SET resource_manager_plan = ''; 语句禁用所有资源计划。