THROTTLE | OceanBase 文档中心

文档反馈

分布式版-V3.1.3社区版

文档概览
使用指南
开发者指南
- 连接 OceanBase 数据库
- 应用程序开发
- 创建和管理数据库对象
- 查询
- 关于 DML 语句和事务
- 设计规范和约束
- SQL 实践和建议
- 常见报错与处理
- SQL 参考
  - 基本元素
  - 运算符
  - 函数
  - 查询和子查询
  - SQL语句
    - 通用语法
    - ALTER DATABASE
    - ALTER OUTLINE
    - ALTER RESOURCE POOL
    - ALTER RESOURCE UNIT
    - ALTER SYSTEM
      - BACKUP
      - BALANCE TASK
      - BOOTSTRAP
      - CANCEL MIGRATE UNIT
      - CLUSTER
      - CONVERT
      - DELETE BACKUPSET
      - DELETE OBSOLETE BACKUP
      - FAILOVER
      - JOB
      - MERGE
      - MIGRATE UNIT
      - PARAMETER
      - REFRESH
      - REPLICA
      - RESTORE
      - ROOTSERVICE
      - SERVER
      - SWITCHOVER
      - THROTTLE
      - UPGRADE
      - ZONE
      - FLUSH PLAN CACHE
    - ALTER TABLE
    - ALTER TABLEGROUP
    - ALTER TENANT
    - ALTER USER
    - ALTER VIEW
    - AUDIT
    - CREATE DATABASE
    - CREATE INDEX
    - CREATE OUTLINE
    - CREATE RESOURCE POOL
    - CREATE RESOURCE UNIT
    - CREATE RESTORE POINT
    - CREATE TABLE
    - CREATE TABLEGROUP
    - CREATE TENANT
    - CREATE USER
    - CREATE VIEW
    - DEALLOCATE PREPARE
    - DELETE
    - DESCRIBE
    - DROP DATABASE
    - DROP INDEX
    - DROP OUTLINE
    - DROP RESOURCE POOL
    - DROP RESOURCE UNIT
    - DROP RESTORE POINT
    - DROP TABLE
    - DROP TABLEGROUP
    - DROP TENANT
    - DROP USER
    - DROP VIEW
    - EXECUTE
    - EXPLAIN
    - FLASHBACK
    - GRANT
    - HELP
    - INSERT
    - KILL
    - LOAD DATA
    - OPTIMIZE
    - PREPARE
    - PURGE
    - PURGE RECYCLEBIN
    - RENAME TABLE
    - RENAME USER
    - REPLACE
    - REVOKE
    - SAVEPOINT
    - SCHEMA
    - SELECT
    - SELECT INTO
    - SET
    - SET CHARSET
    - SET DECRYPTION
    - SET ENCRYPTION
    - SET NAMES
    - SET PASSWORD
    - SET TRANSACTION
    - SHOW
    - TRANSACTION
    - TRUNCATE TABLE
    - UPDATE
    - USE
系统架构
版本发布记录
生态工具
术语

THROTTLE

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

分享

描述

该语句用来设置 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。有关该变量的详细信息，请参见系统变量。例如 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 的请求限流。

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

有帮助

无帮助