更新时间：2025-08-18 GMT+08:00
使用TaurusDB的SQL限流
操作场景
SQL限流功能主要解决用户某类突发的并发过高的SQL导致TaurusDB实例不稳定的问题。当前SQL限流功能支持查看当前限流规则已拦截次数。需注意执行新增、删除规则的操作，所有对应类型的限流规则的已拦截次数会清零；执行节点重启、打开特性开关操作，所有SELECT/UPDATE/DELETE/INSERT类型的限流规则的已拦截次数均会清零。
版本约束
满足如下版本要求的TaurusDB可以使用SQL限流功能。
- 内核版本大于等于2.0.28.15且小于2.0.28.40。
- 内核版本大于等于2.0.29.1。
- 内核版本大于等于2.0.54.240600时，支持“INSERT”类型的限流规则。
约束限制
- 单个限流规则最大支持128个关键字，关键字不能是单个反斜杠（\） 或单个空字符（' '）。关键字首尾的空格和特殊空白字符（如'\t'、'\r'、'\n'）都会被忽略掉。
- 限流规则不能以“~”结尾。
- 限流规则对关键字有顺序要求，会按照关键字设置顺序进行匹配。如关键字设置为a~and~b，“xxx a>1 and b>2”语句符合关键字顺序会被限流，“xxx b>2 and a>1”语句因不符合关键字顺序而不会被限流。
- 添加SQL限流规则后，已经执行中的SQL不会被新添加的规则限制，只有系统新收到的SQL才会进行规则匹配。
- 若主节点和只读节点设置了不一样的限流规则，实例主节点和只读节点倒换之后，新的主节点规则和原来的只读节点一样，新的只读节点规则和原来的主节点一样。
- 当SQL语句匹配多条限流规则时，优先生效最新添加的规则，之前的规则将不再生效。
- 在添加SQL限流规则之前，已经开始执行的SQL语句，不会被计入并发数。
- TaurusDB内核版本大于等于2.0.54.240600时，单个SQL类型（SELECT、UPDATE、DELETE、INSERT）的所有规则和对应的并发数加起来长度不能超过4000 bytes，单条规则长度不能超过1000 bytes。
- TaurusDB内核版本小于2.0.54.240600时，单个SQL类型（SELECT、UPDATE、DELETE）的所有规则和对应的并发数加起来长度不能超过1024 bytes。
- 当限流规则数量较多时，SELECT/UPDATE/DELETE/INSERT语句会有小幅度的性能劣化。
- 限流SQL的匹配规则为前缀匹配。例如：限流规则为“SELECT~COUNT~t1”, SQL语句“SELECT COUNT(*) FROM t1”和“SELECT COUNT(*) FROM t1 LIMIT 1”都会被拦截。
- 限流触发后业务侧会收到执行报错，报错信息为“ERROR 1317 (70100): Query execution was interrupted”。
- 需注意对某一类型的限流规则执行新增、删除规则的操作时，所有该类型的限流规则将重新生成；执行节点重启、打开SQL限流开关操作，所有SELECT/UPDATE/DELETE/INSERT类型的限流规则将重新生成。重新生成的限流规则的当前并发数以及已拦截次数将清零重新计算。
- 以下场景不受SQL限流的限制：
- 系统表不限制。
- 不涉及数据查询的语句不限制，如“select sleep(xxx)；”语句。
- root账号不限制。
- 存储过程、触发器、函数内的SQL不限制。
新增限流规则
- 登录管理控制台。
- 单击管理控制台左上角的
，选择区域和项目。 - 在页面左上角单击
，选择。 - 在“实例管理”页面，选择目标实例，单击实例名称，进入实例概览页面。
- 在左侧导航栏选择“智能DBA助手 > 历史诊断”。
- 选择“全量SQL > SQL限流”。
- 在“SQL限流”页面，开启SQL限流开关。
- 单击“新建SQL限流规则”，选择需要限流的SQL类型、关键字以及最大并发数。
图1 新建SQL限流规则
表1 SQL限流规则参数 参数项
说明
SQL类型
支持选择四种类型：SELECT、UPDATE、DELETE、INSERT。
关键字
最多支持128个关键字，不区分大小写。支持以下两种方式输入关键字。
- 直接输入关键字：例如关键字是“select~a”，含义为：select以及a为该并发控制所包含的两个关键字，~为关键字间隔符，也就是说如果执行SQL语句中包含select与a两个关键字，那么命中此条并发控制规则。
- 原始SQL生成关键字：输入原始SQL再单击“生成关键字”，生成的关键字仅供参考，请谨慎使用。
关键字根据顺序匹配SQL语句。例如：a~and~b只会匹配*** a>1 and b>2，而不会匹配*** b>2 and a>1。
单个关键字首尾的空白字符会被忽略，包括' '、'\n'、'\r'、'\t'等。
最大并发数
输入最大并发数，与关键字匹配的SQL语句如果超过最大并发数会被拒绝执行。取值范围为0~1000000000。
kill满足规则的已有会话
勾选此选项后，会结束所有受SQL限流规则控制的账户所产生的会话。
同步规则给其他节点
勾选此选项后，将新增的限流规则同步给同一实例的其他节点。
- 确认无误后，单击“确定”。
- 提示确认框中单击“确定”。
删除限流规则
- 登录管理控制台。
- 单击管理控制台左上角的，选择区域和项目。
- 在页面左上角单击，选择。
- 在“实例管理”页面，选择目标实例，单击实例名称，进入实例概览页面。
- 在左侧导航栏选择“智能DBA助手 > 历史诊断”。
- 选择“全量SQL > SQL限流”。
- 选择目标SQL限流规则，单击操作列的“删除”。
您也可以选择一条或多条限流规则，单击上方的“批量删除”。
- 弹框中确认删除的限流规则信息，如果勾选“同步规则给其他节点”，表示同一实例的其他节点的限流规则也会被删除，确认无误后单击“确定”。
图2 删除限流规则
