调用EnableSqlConcurrencyControl接口启用SQL限流来控制数据库请求访问量和SQL并发量。
本接口适用的数据库引擎为:
- RDS MySQL
- PolarDB MySQL
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | EnableSqlConcurrencyControl |
系统规定参数。取值:EnableSqlConcurrencyControl。 |
ConsoleContext | String | 否 | None |
备用参数。 |
InstanceId | String | 是 | rm-2ze1jdv45i7l6**** |
实例ID。 说明 仅支持RDS MySQL和 PolarDB MySQL实例。
|
SqlType | String | 是 | SELECT |
选择SQL的类型。取值:
|
MaxConcurrency | Long | 是 | 3 |
SQL最大并发数,取值为大于或等于1的整数。 说明 当包含关键词的SQL达到最大并发数时会触发限流规则。
|
SqlKeywords | String | 是 | call~open~api~test~4~from~POP |
需要限流的SQL关键词。 说明 多个关键词间用波浪线(~)分隔,SQL语句中需要同时包含这些关键词才会触发限流规则。
|
ConcurrencyControlTime | Long | 是 | 300 |
SQL限流的生效时长,单位为秒。 说明 限流规则仅在生效时间内开启。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | 200 |
返回的状态码。 |
Message | String | Successful |
请求返回消息。 说明 请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。
|
Data | String | Null |
详细信息列表,包括信息总数、错误码等。 |
RequestId | String | B6D17591-B48B-4D31-9CD6-9B9796B2**** |
请求ID。 |
Success | String | true |
请求是否执行成功:
|
示例
请求示例
http(s)://das.cn-shanghai.aliyuncs.com/?Action=EnableSqlConcurrencyControl
&ConsoleContext=None
&InstanceId=rm-2ze1jdv45i7l6****
&SqlType=SELECT
&MaxConcurrency=3
&SqlKeywords=SELECT~min~id~max~id~FROM~task_event~WHERE~gmt_modified~AND~begin_time
&ConcurrencyControlTime=300
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<EnableSqlConcurrencyControlResponse>
<Code>200</Code>
<Message>Successful</Message>
<Data>"Data": { "total": 1, "list":[...] }, "Code": 200, "Success": true }</Data>
<RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
<Success>true</Success>
</EnableSqlConcurrencyControlResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Code" : "200",
"Message" : "Successful",
"Data" : "\"Data\": { \"total\": 1, \"list\":[...] }, \"Code\": 200, \"Success\": true }",
"RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
"Success" : "true"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParams | The request parameters are invalid. | 请求参数错误 |
访问错误中心查看更多错误码。