---
title: "ALTER OUTLINE - OceanBase 数据库 V4.2.1 | OceanBase 文档中心"
description: "ALTER OUTLINE 描述 该语句用于添加绑定 Outline 和限流规则，仅支持修改使用 SQL_TEXT 创建的 Outline。 语法 ALTER OUTLINE outline_name ADD stmt [ TO target_stmt ]; 参数解释 参数 描述 outline_name 指定要修改…"
---
切换语言

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

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

# ALTER OUTLINE

更新时间：2026-07-15 20:56:55

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.1/zh-CN/700.reference/500.sql-reference/100.sql-syntax/200.common-tenant-of-mysql-mode/600.sql-statement-of-mysql-mode/1300.alter-outline-of-mysql-mode.md)  

## 描述

该语句用于添加绑定 Outline 和限流规则，仅支持修改使用 `SQL_TEXT` 创建的 Outline。

## 语法

```sql
ALTER OUTLINE outline_name ADD stmt [ TO target_stmt ];

```

## 参数解释

| **参数** | **描述** |
| --- | --- |
| outline_name | 指定要修改的 Outline 名称。 |
| stmt | 一般为一个带有 Hint 和原始参数的 DML 语句。 |
| TO target_stmt | 如果不指定 `TO target_stmt`， 则表示如果数据库接受的 SQL 参数化后与 `stmt` 去掉 Hint 参数化文本相同，则将该 SQL 绑定 `stmt` 中 Hint 生成执行计划；如果期望对含有 Hint 的语句进行固定计划，则需要 `TO target_stmt` 来指明原始的 SQL。    **注意** 在使用 `target_stmt` 时，严格要求 `stmt` 与 `target_stmt` 在去掉 Hint 后完全匹配。 |

## 示例

- 通过 `ALTER OUTLINE` 来添加限流规则。

  ```sql
  obclient> ALTER OUTLINE ol_1 ADD SELECT /*+max_concurrent(1)*/ * FROM t1 WHERE c1 = 1 and c2 = ?;
  obclient> ALTER OUTLINE ol_1 ADD SELECT /*+max_concurrent(1)*/ * FROM t1 WHERE c1 = ? and c2 = 1;

  ```
 - 通过 `ALTER OUTLINE` 来添加执行计划。

  ```sql
  obclient> CREATE OUTLINE ol_2 ON SELECT /*+max_concurrent(1)*/ * FROM t1,t2 WHERE t1.c1 = 1;
  obclient> ALTER OUTLINE ol_2 ADD SELECT /*+use_nl(t2)*/ * FROM t1,t2 WHERE t1.c1 = 1;

  ```

## 注意事项

- 同一个 `outline_name` 只能指定一个执行计划。如果通过 `CREATE OUTLINE` 语句指定了执行计划，则无法通过执行 `ALTER OUTLINE` 时再添加。
 - 与 `CREATE OUTLINE` 类似，在 `ALTER OUTLINE` 时不能同时指定限流规则和执行计划。

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