---
title: "THROTTLE | OceanBase 文档中心"
description: "THROTTLE 描述 该语句用来设置 SQL 特征限流。让符合设置限流特征的 SQL 请求提早失败，避免它对正常请求造成影响。 alter_system_throttle_stmt: ALTER SYSTEM throttle_action; throttle_action: ENABLE SQL THROTTLE…"
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 3.1.3 社区版

# THROTTLE

更新时间：2023-08-07 17:30:43

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V3.1.3/zh-CN/1400.developer-guide/700.sql-reference/500.sql-statements/600.alter-system/2200.throttle.md)  

## 描述

该语句用来设置 SQL 特征限流。让符合设置限流特征的 SQL 请求提早失败，避免它对正常请求造成影响。

```sql
alter_system_throttle_stmt:
    ALTER SYSTEM throttle_action;

throttle_action:
      ENABLE SQL THROTTLE [priority_option] [using_metric_option_list]
    | DISABLE SQL

priority_option:
    FOR PRIORITY <= INT_VALUE

using_metric_option_list:
    USING metric_option_list

metric_option_list:
    metric_option [metric_option ...]

metric_option:
      RT = {INT_VALUE | DECIMAL_VALUE}
    | CPU = {INT_VALUE | DECIMAL_VALUE}
    | IO = INT_VALUE
    | NETWORK = {INT_VALUE | DECIMAL_VALUE}
    | QUEUE_TIME = {INT_VALUE | DECIMAL_VALUE}
    | LOGICAL_READS = {INT_VALUE | DECIMAL_VALUE}

```

## 参数解释

| **参数** | **描述** |
| --- | --- |
| ENABLE SQL | 开启限流，后接限流特征及特征值。 |
| FOR PRIORITY | 设定受到限流影响的优先级，目的是限流影响只在部分 Session 生效。 您可以通过会话级变量 `sql_throttle_priority` 设置当前会话的优先级，默认为 100。有关该变量的详细信息，[请参见系统变量](https://www.oceanbase.com/docs/community-observer-cn-10000000000096935)。 例如 Session `a`、`b`、`c` 优先级分别为 `1`、`2`、`3`，设置 `ALTER SYSTEM ENABLE SQL THROTTLE FOR PRIORITY <= 2 USING QUEUE_TIME=0.1;` 表示 Session `a`、`b` 受限流影响，而 `c` 不受限流影响。 |
| RT | 按 SQL 响应时间（Response Time）限流。 |
| CPU | 按 CPU 占用限流。   > **说明**   >  当前版本暂不支持该参数。 |
| IO | 按 IO 次数限流。   > **说明**   >  当前版本暂不支持该参数。 |
| NETWORK | 按传输的网络流量大小限流。   > **说明**   >  当前版本暂不支持该参数。 |
| QUEUE_TIME | 按队列等待时间限流。 |
| LOGICAL_READS | 按逻辑读次数限流。   > **说明**   >  当前版本暂不支持该参数。 |
| DISABLE SQL | 关闭限流。 |

## 示例

对 `PRIORITY` 小于等于 `100` 的 Session 上队列等待时间超过 `0.1s` 的请求限流。

```sql
obclient> ALTER SYSTEM ENABLE SQL THROTTLE FOR PRIORITY <= 100 USING QUEUE_TIME=0.1;

```

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