---
title: "ALTER_SQL_PLAN_BASELINE - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: ALTER_SQL_PLAN_BASELINE ALTER_SQL_PLAN_BASELINE 函数用于修改基线中一个或一组计划的属性。返回值表示被修改的基线数量。 语法 DBMS_SPM.ALTER_SQL_PLAN_BASELINE ( sql_handle IN VARCHAR, plan_name IN VA…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.3.5 LTS

# ALTER_SQL_PLAN_BASELINE

更新时间：2026-07-15 20:42:46

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.3.5/zh-CN/700.reference/600.pl-reference/300.pl-oracle/1400.pl-system-package-oracle/15000.dbms-spm-oracle/300.alter-sql-plan-baseline-oracle.md)  

`ALTER_SQL_PLAN_BASELINE` 函数用于修改基线中一个或一组计划的属性。返回值表示被修改的基线数量。

## 语法

```sql
DBMS_SPM.ALTER_SQL_PLAN_BASELINE (
  sql_handle        IN VARCHAR,
  plan_name         IN VARCHAR := NULL,
  attribute_name    IN VARCHAR,
  attribute_value   IN VARCHAR
)
RETURN PLS_INTEGER;

```

## 参数说明

| **参数名称** | **说明** |
| --- | --- |
| database_name | 数据库名称，仅 MySQL 模式下需要指定该参数。 |
| sql_handle | SQL 的标识符，也就是 `SQL_ID`。 |
| plan_name | 计划的名称，也就是 Plan Hash Value。如果值为 `NULL`，表示接受一个 SQL 所有正在演进的计划。 |
| attribute_name | 计划的属性名称。请参见 **属性说明**。 |
| attribute_value | 计划的属性值。请参见 **属性说明**。 |

## 属性说明

| **属性名称** | **可取的属性值** | **描述** |
| --- | --- | --- |
| enabled | 'YES' 或 'NO' | 'YES' 表示计划基线是有效的。最终计划基线是否会被使用取决于是否被接受。 |
| fixed | 'YES' 或 'NO' | 'YES' 表示优先使用当前计划基线，并且**不进行自动演进**。 |
| autopurge | 'YES' 或 'NO' | 'YES' 表示计划基线一段时候没有使用后会被自动淘汰；'NO' 表示计划基线永不淘汰。 |
| plan_name | 字符串，最多 30 个字符。 | 计划的名称。 |
| description | 字符串，最多 500 个字节。 | 计划的描述。 |

## 示例

将某个 Plan Baseline 固化后该 SQL 仅使用该计划。

```sql
DECLARE
  v_alter_plans NUMBER;
BEGIN
  v_alter_plans := DBMS_SPM.ALTER_SQL_PLAN_BASELINE(
     sql_handle => '529F6E6454EF579C7CC265D1F6131D70',
     plan_name => '3388268709115914355',
     attribute_name => 'fixed',
     attribute_value => 'YES' );
END;
/

```

 上一篇 下一篇 ![有帮助](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) 咨询热线