---
title: 低版本禁用 SPM-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于 低版本禁用 SPM相关的常见问题和使用技巧，帮助您快速解决 低版本禁用 SPM的难题。
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

划线反馈

# 低版本禁用 SPM

更新时间：2026-05-14 07:41

适用版本： V2.2.x、V3.1.x、V3.2.x 内容类型：Troubleshoot  

## 问题现象

租户系统变量 `optimizer_use_sql_plan_baselines` 为 true 的场合会开启 SPM 功能，会通过内部表持久化 plan。在 OceanBase 数据库 V4.0 之前版本，SPM 会由 SQL 自动生成 `plan_baseline schema` 对象并通过 schema 的机制同步给整个集群。该方式有以下几个问题。

1. 持久化 ·plan_baseline schema· 对象需要走 DDL，由于 DDL 是集群内串行执行，由 SQL 自动触发的大量 DDL 可能会影响到业务正常的 DDL。
 2. `plan_baseline schema` 对象缺乏自动清理的机制，随着 SQL 的执行，`plan_baseline schema` 对象会越来越多，只增不减。这伴随两个问题。

      - `plan_baseline schema` 对象过多导致 schema 内存占用大。
      - `plan_baseline schema` 对象过多导致 OBServer 重启全量刷新 schema 耗时长，或者超时。

OceanBase 数据库 V4.0 之后 SPM 的功能经过重构，不再走 DDL 及依赖 schema。OceanBase 数据库 V4.0 之前的版本需要禁用 SPM 功能。

## 关键诊断信息

### 触发条件

低版本中租户系统变量 `optimizer_use_sql_plan_baselines` 为 true。

## 问题的风险及影响

1. 影响业务 DDL 执行。
 2. schema 内存占用大，且重启也无法有效释放。
 3. 影响 OBServer 重启。

## 影响租户

OceanBase 数据库企业版 V2.2.77 GA（oceanbase-2.2.77-20210508211731）及之后版本、V3.1.2 GA（oceanbase-3.1.2-20210618150922）及之后版本、V3.2.3 GA（oceanbase-3.2.3.0-20220418212020）及之后版本。

## 解决方法

1. 租户关闭 SPM 功能。

   ```shell
   set @@global.optimizer_use_sql_plan_baselines = '0';

   ```
 2. 遇到 OBServer 重启 schema 刷新持续报 -4012 时，可以尝试调大集群级配置项，恢复后需要还原为缺省值 30s。

   ```shell
   ALTER SYSTEM SET internal_sql_execute_timeout = '10M';

   ```

上一篇

[Batch NLJ+except op 正交导致查询结果错误](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000002931389)

下一篇

[OceanBase 数据库中执行 insert into select from 多表 join SQL 报错 -4016,Internal error 的原因和解决方法](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000001928612) ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
