---
title: "CREATE CONCURRENT_LIMITING_RULE - OceanBase 数据库 V4.3.5 | OceanBase 文档中心"
description: CREATE CONCURRENT_LIMITING_RULE 说明 该语句从 OceanBase 数据库 V4.3.5 BP3 版本开始引入。 描述 该语句用于创建限流规则，指定限流范围来限制特定 SQL 的并发度。 权限要求 执行 CREATE CONCURRENT_LIMITING_RULE 语句，需要当前用户…
---
切换语言

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

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

# CREATE CONCURRENT_LIMITING_RULE

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

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

#### 说明

该语句从 OceanBase 数据库 V4.3.5 BP3 版本开始引入。

## 描述

该语句用于创建限流规则，指定限流范围来限制特定 SQL 的并发度。

## 权限要求

执行 `CREATE CONCURRENT_LIMITING_RULE` 语句，需要当前用户拥有 CREATE 权限。有关 OceanBase 数据库权限的详细介绍，请参见 [MySQL 模式下的权限分类](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000002016100)

## 语法

```sql
CREATE CONCURRENT_LIMITING_RULE [ IF NOT EXISTS ] `ccl_rule_name`
ON `database`.`table`
TO '<usename>'@'ip'
FOR { ALL | UPDATE | SELECT | INSERT | DELETE }
filter_options:
    [ FILTER BY KEYWORD('KEYWORD1', 'KEYWORD2',…) ]
 with_options:
    WITH MAX_CONCURRENCY = value1 [per sql]

```

## 参数解释

| 参数 | 描述 |
| --- | --- |
| `ccl_rule_name` | 必选，表示限流规则的名称。   #### 说明    为避免名称与 SQL 关键字冲突，建议在规则名称前后各加一个反引号（`） |
| `database`.`table` | 必选，表示数据库和数据表的名称，支持使用星号（*）表示任意匹配。   #### 说明    为避免名称与 SQL 关键字冲突，建议在规则名称前后各加一个反引号（`） |
| `<usename>@<host>` | 必选，表示账号名称。其中，username 支持 * 表示所有用户，Host 部分支持用百分号（%）来表示任意匹配。 |
| `ALL`\|`UPDATE \\| SELECT \\| INSERT\\| DELETE` | 必选，表示 SQL 语句类型。当前支持`ALL`、`UPDATE`、`SELECT`、`INSERT` 和 `DELETE` 类型。   #### 说明    每条限流规则仅支持传入一种类型的 SQL 语句。 |
| `[ filter_options ]` | 可选，表示限流关键字。   #### 说明    - 关键字之间将用通配符`%`连接，例如给定 3 个关键词`'asdasd', 'c2 = 123', 'xxyyzz'`，其会被拼成 `'%asdasd%c2 = 123%xxyyzz%'`，后续将按照这个字符串进行 SQL 文本的通配匹配。 - 当关键字中有`'_'`时会被转义，如`'table_t1'`会被记录成`'%table_t1%'`。 - 限流关键字无个数限制，但限制拼凑后的字符串长度不能超过 `OB_MAX_VARCHAR_LENGTH=1048576`。 |
| `with_options` | 必选，用于控制限流的并发度, 并且指定限流统计粒度是规则级别的还是 Format SQLID 语句级别的。目前仅支持 `MAX_CONCURRENCY` 参数，表示匹配到该限流规则的 SQL 语句的最大并发度。 |

## 示例

执行如下命令进行关键词限流：

```shell
obclient> CREATE CONCURRENT_LIMITING_RULE IF NOT EXISTS  `sql1_keywords_ccl_rule`
ON *.* TO '%'@'%' FOR SELECT
FILTER BY KEYWORD('table1', 'table2', 'c1') WITH MAX_CONCURRENCY 100;

```

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