全部产品
Search
文档中心

云原生数据仓库AnalyticDB:DescribeBadSqlDetection - 查看BadSQL

更新时间:Jan 08, 2026

查看一段时间范围内影响实例稳定的BadSQL。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
adb:DescribeBadSqlDetectionget
DBCluster
acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId}

请求参数

名称类型必填描述示例值
DBClusterIdstring

集群 ID。

说明 您可以通过 DescribeDBClusters 接口查询账号下所有集群的信息详情。
am-xxx
RegionIdstring

地域 ID。

说明 您可以调用 DescribeRegions 接口查看指定 AnalyticDB MySQL 数仓版集群的地域 ID。
cn-hangzhou
StartTimestring

查询开始时间,格式为 yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

2021-05-18T06:00:00Z
EndTimestring

查询结束时间,需要大于查询开始时间。格式:yyyy-MM-ddTHH:mmZ(UTC 时间)。

2021-09-30T00:15Z
Langstring

语言配置,取值说明:

  • zh(默认值):简体中文。
  • en:英文。
  • ja:日文。
  • zh-tw:繁体中文。
zh

返回参数

名称类型描述示例值
object
TotalCountstring

总记录数。

5
RequestIdstring

请求 ID。

32C6E870-81E5-5E2A-BE7D-F9623F090DAB
DBClusterIdstring

集群 ID。

am-xxx
DetectionItemsarray<object>

检测项及检测结果列表。

OpenApiFasDetectionItemobject
Namestring

检测项。

PeakMemory OperatorCost ScanSize
Resultsarray<object>

检测项的检测结果。

BadSqlDiagnosisResultobject

检测结果对象。

Costlong

查询的总耗时。单位:毫秒。

说明 该耗时指标是QueuedTimeTotalPlanningTimeExecutionTime三个耗时指标的累加值。
37
PeakMemorylong

查询的峰值内存。

1234
OperatorCostlong

该阶段内部总的算子耗时,等同于该阶段的 CPU Time,可用于判断查询哪些部分消耗了较多的计算资源。单位为毫秒(ms)。

12345
ScanSizelong

扫描数据量,单位:Byte。

1234
OutputDataSizelong

返回数据量,单位:Byte。

1234
ProcessIdstring

查询 ID。

2023120808405202104101604703151654257
TotalStagesinteger

查询生成的总 Stage 数量。

123
DiagnosisResultsarray<object>

BadSQL 查询诊断结果。

BasicDiagnosisInfoobject
Codestring

诊断码。

FILTER_NOT_PUSHDOWN
Detailstring

查询诊断结果详情。

查询消耗了较多的内存资源,请进行查询内存调优
StageIdstring

StageID。

Stage[1]
OperatorIdstring

算子 ID。

Join[234]
SQLstring

SQL 语句详情。

说明 出于性能考虑,当前 SQL 语句最长支持显示 5120 个字符,超出限制的 SQL 语句会被截断。您可以调用 DownloadDiagnosisRecords 接口下载符合指定条件的 SQL 语句的摘要信息,包括完整的 SQL 语句。
select * from user
PatternIdstring

SQL Pattern 的 ID。

-5978869478527645300
StartTimestring

查询开始时间。格式:yyyy-MM-ddTHH:mmZ(UTC 时间)。

2024-05-05T02:13Z
Statusstring

检测结果状态。

NORMAL WARNNING CRITICAL
Messagestring

诊断结果信息。

检测到多条BadSQL,请进行优化
AccessDeniedDetailstring

访问被拒绝详细信息。

{ "PolicyType": "AccountLevelIdentityBasedPolicy", "AuthPrincipalOwnerId": "1*****************7", "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==", "AuthPrincipalType": "SubUser", "AuthPrincipalDisplayName": "2***************9", "NoPermissionType": "ImplicitDeny", "AuthAction": "adb:DescribeExcessivePrimaryKeys" }

示例

正常返回示例

JSON格式

{
  "TotalCount": 5,
  "RequestId": "32C6E870-81E5-5E2A-BE7D-F9623F090DAB",
  "DBClusterId": "am-xxx",
  "DetectionItems": [
    {
      "Name": "PeakMemory\nOperatorCost\nScanSize",
      "Results": [
        {
          "Cost": 37,
          "PeakMemory": 1234,
          "OperatorCost": 12345,
          "ScanSize": 1234,
          "OutputDataSize": 1234,
          "ProcessId": 2.023120808405202e+36,
          "TotalStages": 123,
          "DiagnosisResults": [
            {
              "Code": "FILTER_NOT_PUSHDOWN",
              "Detail": "查询消耗了较多的内存资源,请进行查询内存调优",
              "StageId": "Stage[1]",
              "OperatorId": "Join[234]"
            }
          ],
          "SQL": "select * from user",
          "PatternId": -5978869478527646000,
          "StartTime": "2024-05-05T02:13Z"
        }
      ],
      "Status": "NORMAL\nWARNNING\nCRITICAL",
      "Message": "检测到多条BadSQL,请进行优化"
    }
  ],
  "AccessDeniedDetail": {
    "PolicyType": "AccountLevelIdentityBasedPolicy",
    "AuthPrincipalOwnerId": "1*****************7",
    "EncodedDiagnosticMessage": "AQIBIAAAAOPdwKY2QLOvgMEc7SkkoJfj1kvZwsaRqNYMh10Tv0wTe0fCzaCdrvgazfNb0EnJKETgXyhR+3BIQjx9WAqZryejBsp1Bl4qI5En/D9dEhcXAtKCxCmE2kZCiEzpy8BoEUt+bs0DmlaGWO5xkEpttypLIB4rUhDvZd+zwPg4EXk4KSSWSWsurxtqDkKEMshKlQFBTKvJcKwyhk62IeYly4hQ+5IpXjkh1GQXuDRCQ==",
    "AuthPrincipalType": "SubUser",
    "AuthPrincipalDisplayName": "2***************9",
    "NoPermissionType": "ImplicitDeny",
    "AuthAction": "adb:DescribeExcessivePrimaryKeys"
  }
}

错误码

HTTP status code错误码错误信息描述
404InvalidDBCluster.NotFoundThe DBClusterId provided does not exist in our records.您指定的 DBClusterId 不存在,请确认 DBClusterId 值是否正确。

访问错误中心查看更多错误码。