SQL限流

应用场景

操作步骤

1. 登录DAS控制台。
2. 在左侧导航栏中，单击实例监控。
3. 找到目标实例，单击实例ID，进入目标实例详情页。
4. 在左侧导航栏，单击实例会话。
5. 在实例会话页面，单击SQL限流。
   
6. 在弹出的SQL限流对话框，配置如下参数。
   

   参数	说明
   限流模式	选择限流模式，详情请参见限流模式。
   SQL类型	选择SQL类型，取值如下：SELECT、UPDATE、DELETE。
   最大并发度	SQL最大并发数，当包含关键词的SQL达到最大并发数时会触发限流策略。最大并发度允许设置的最小值为1。
   限流时间	SQL限流的生效时间。SQL限流是应急措施，建议您按实际需求设置限流时长，用完及时关闭。
   SQL关键词	需要限流的SQL关键词。若您设置多个关键词，则SQL语句中需要同时包含这些关键词才会触发限流规则，多个关键词间用波浪线（~）分隔。不支持只设置SELECT、UPDATE、DELETE为限流关键词，且关键词大小写敏感（部分早期版本实例不区分）。关键词设置举例：如原始语句SELECT min(id), max(id) FROM task_event WHERE gmt_modified < '2020-06-21' AND begin_time > '2020-07-09' AND source IN (527) AND id >= 15673 AND id <= 8015673 ，则对应该语句的限流关键词为SELECT~min~id~max~id~FROM~task_event~WHERE~gmt_modified~AND~begin_time~AND~source~IN~AND~id~AND~id 。
   被限流SQL的数据库账号	输入被限流SQL的数据库账号。

   说明 目标SQL规则创建后，当应用端使用了同时包含所有关键词的SQL：

   • RDS MySQL 5.6、RDS MySQL 5.7的实例和PolarDB MySQL 5.6的集群会返回1317错误（query execution was interrupted）。
   • RDS MySQL 8.0实例、PolarDB MySQL 5.7和PolarDB MySQL 8.0集群会让相关SQL会处于Concurrency control waiting状态，直至等待数量超过ccl_max_waiting_count参数的值（如果实例版本支持该参数）时，会返回错误码和错误描述（Concurrency control waiting count exceed max waiting count），错误码分别是：
     • RDS MySQL 8.0为ERROR 7534 (HY000)。
     • PolarDB MySQL 5.7为ERROR 3277 (HY000)。
     • PolarDB MySQL 8.0为ERROR 7533 (HY000)。

     其中，若ccl_max_waiting_count参数值为默认值0时，所有被限流的SQL均会处于Concurrency control waiting状态，不返回错误。通过DAS限流时，若该参数值为0，DAS会将其值设置为DAS的默认值；若用户将其设置为大于0的其他值，DAS不再设置该参数，直接使用用户的设置。

7. 单击创建。
8. SQL限流规则创建完成后，您可以在SQL限流列表查看SQL规则的状态。
   
9. 如您需要提前关闭或修改限流规则，可单击目标规则右侧操作栏的关闭或修改按钮。

限流模式

您可选择如下三种模式中的一种作为限流模式：

相关API

• EnableSqlConcurrencyControl
• DisableSqlConcurrencyControl
• DisableAllSqlConcurrencyControl
• GetRunningSqlConcurrencyControlRules
• GetSqlConcurrencyControlRulesHistory
• GetSqlConcurrencyControlKeywordsFromSqlText