SPM 基线自动清理说明

对于开启 SPM 功能的租户，随着业务变更、动态查询等原因可能保留了大量已经不再使用的基线，这些基线的数量会随着时间积累而增长。 OceanBase 能够自动定期清理这些基线，并对不再使用基线保留的时间进行设置。

详细说明

对于开启 SPM 功能的租户，数据库中执行过的查询会自动添加基线（在 V4.2.5 BP4、V4.3.5 BP4、V4.4.1 及之后的版本，计划在 plan cache 中保留且执行超过 150 次会添加基线，这些版本之前的版本，计划成功执行一次就会添加基线）。 如果业务存在频繁变更、存在大量动态查询等情况，数据库中会保留了大量已经不再使用的基线，这些基线的数量会随着时间积累而增长。 为了避免大量不再使用的基线占用磁盘空间、对 SPM 功能正常执行造成影响，OceanBase 实现了自动基线清理功能，每天凌晨 1:00 执行定时任务，调用 DBMS_SPM.AUTO_PURGE_SQL_PLAN_BASELINE 对长时间不再使用基线进行清理。 基线保留时间可以通过以下方式进行查询和配置，早期版本默认保留一年时间的基线（即 53 周），较新版本将这一默认值调整为了 7 周，从低版本升级的版本仍保留原始设置，升级后可以根据需要进行配置。建议保留基线时间在一个月以上，避免月结、跑批等查询等基线被清理。

-- oracle 模式设置及查询基线保留时间
call DBMS_SPM.CONFIGURE('plan_retention_weeks', 5);
select * from sys.DBA_SQL_MANAGEMENT_CONFIG where PARAMETER_NAME = 'PLAN_RETENTION_WEEKS';
+----------------------+-----------------+----------------------------+-------------+
| PARAMETER_NAME       | PARAMETER_VALUE | LAST_MODIFIED              | MODIFIED_BY |
+----------------------+-----------------+----------------------------+-------------+
| PLAN_RETENTION_WEEKS | 5               | 2025-09-19 11:12:40.231801 | TEST        |
+----------------------+-----------------+----------------------------+-------------+

-- MySQL 模式设置及查询基线保留时间
call DBMS_SPM.CONFIGURE('test', 'plan_retention_weeks', 5);
select * from oceanbase.DBA_SQL_MANAGEMENT_CONFIG where PARAMETER_NAME = 'PLAN_RETENTION_WEEKS';
+----------------------+-----------------+----------------------------+-------------+
| PARAMETER_NAME       | PARAMETER_VALUE | LAST_MODIFIED              | MODIFIED_BY |
+----------------------+-----------------+----------------------------+-------------+
| PLAN_RETENTION_WEEKS | 5               | 2025-09-19 11:12:20.539905 | test        |
+----------------------+-----------------+----------------------------+-------------+

V4.2.1 版本在 V4.2.1 BP11 Hotfix10 之后具备基线自动清理功能，但从低版本升级到 V4.2.1 BP11 Hotfix10 的租户，需要进行以下操作进行检查。

1. 检查并确认是否存在相关系统包，如果不存在，需要手动升级系统包。

   -- 执行以下查询，如果执行报错 FUNCTION DBMS_SPM.AUTO_PURGE_SQL_PLAN_BASELINE does not exist, 先确认 421 版本是否支持，如果版本已经支持，需要手动升级系统包
   select DBMS_SPM.AUTO_PURGE_SQL_PLAN_BASELINE() from dual;
   
   -- 手动升级系统包，直连到集群中某个server,系统租户下执行如下命令
   alter system set enable_upgrade_mode =true; 
   set ob_compatibility_mode='oracle';
   set ob_query_timeout = 300000000;
   CALL "__DBMS_UPGRADE".UPGRADE_ALL();
   set ob_compatibility_mode='mysql';
   alter system set enable_upgrade_mode = false;
   

2. 检查是否存在清理基线的定时任务，如果不存在，需要手动创建定时任务。

   • Oracle 模式下，在业务租户租户下创建定时任务（维护窗口）：

     -- 查看创建的定时任务
     select * from DBA_SCHEDULER_JOBS where JOB_NAME = 'SPM_STATS_MANAGER'\G
     
     BEGIN
     DBMS_SCHEDULER.CREATE_JOB(
     job_name        => 'SPM_STATS_MANAGER',
     job_type        => 'STORED_PROCEDURE',
     job_action      => 'DBMS_SPM.HANDLE_SPM_STATS_JOB_PROC()',
     start_date      => '2025-09-20 01:00:00.000000', -- 设置为次日 1:00，创建时需要调整该值
     repeat_interval => 'FREQ=DAYLY; INTERVAL=1',
     end_date        => '4000-01-01 00:00:00.000000',
     enabled         => true,
     auto_drop       => false,
     comments        => 'used to handle spm stats',
     max_run_duration => 3600);
     END;
     /
     

   • MySQL 模式下，在系统租户下，为业务租户创建定时任务（维护窗口）：

     -- 在 sys 租户下切换操作业务租户的内部表
     alter system change tenant tenant_id = 1004;
     
     -- 确认以下查询结果为空，即不存在 SPM_STATS_MANAGER job
     select * from __all_tenant_scheduler_job where job_name = "SPM_STATS_MANAGER"\G
     
     -- 获取需要添加的 job 号
     select max(job) + 1 into @next_job from __all_tenant_scheduler_job;
     -- 设置 job 开始时间, 后续每天这个时刻自动执行任务
     set @start_time = '2025-09-25 01:00:00';	-- 设置为次日 1:00, 创建时需要调整该值
     
     -- 在内部表创建 job
     INSERT INTO __all_tenant_scheduler_job( tenant_id, job_name, job, lowner, powner, cowner, next_date,total,`interval#`,flag,what,nlsenv,field1,exec_env,job_style,program_name,job_type,job_action,number_of_argument,start_date,repeat_interval,end_date,job_class,enabled,auto_drop,comments,credential_name,destination_name,interval_ts,max_run_duration)
     VALUES
     (0, "SPM_STATS_MANAGER", @next_job, "root@%", "root@%", "oceanbase", @start_time, 0, "FREQ=DAYLY; INTERVAL=1", 0, "DBMS_SPM.HANDLE_SPM_STATS_JOB_PROC()", "", "", "281018368,45,45,45,2,", "REGULER", "", "STORED_PROCEDURE", "DBMS_SPM.HANDLE_SPM_STATS_JOB_PROC()", 0, @start_time, "FREQ=DAYLY; INTERVAL=1", usec_to_time(64060560000000000), "DEFAULT_JOB_CLASS", 1, 0, "used to handle spm stats", "", "", 86400000000, 3600),
     (0, "SPM_STATS_MANAGER", 0, "root@%", "root@%", "oceanbase", @start_time, 0, "FREQ=DAYLY; INTERVAL=1", 0, "DBMS_SPM.HANDLE_SPM_STATS_JOB_PROC()", "", "", "281018368,45,45,45,2,", "REGULER", "", "STORED_PROCEDURE", "DBMS_SPM.HANDLE_SPM_STATS_JOB_PROC()", 0, @start_time, "FREQ=DAYLY; INTERVAL=1", usec_to_time(64060560000000000), "DEFAULT_JOB_CLASS", 1, 0, "used to handle spm stats", "", "", 86400000000, 3600);
     

适用版本

OceanBase 数据库 V4.2.1 BP11 Hotfix10（oceanbase-4.2.1.11-111100012025092309）及之后版本、V4.2.5 BP4（oceanbase-4.2.5.4-104000082025052817）及之后版本、V4.3.5 BP2 Hotfix9（oceanbase-4.3.5.2-102090012025082611）及之后版本、V4.3.5 BP3 Hotfix2（oceanbase-4.3.5.3-103020012025082017）及之后版本、V4.3.5 BP4（oceanbase-4.3.5.4-104000052025090918）及之后版本、V4.4.1（oceanbase-4.4.1.0-100000242025092415）及之后版本。