DescribeDiagnosisRecords - 查看SQL摘要信息 - 云原生数据仓库AnalyticDB

调用DownloadDiagnosisRecords接口查看目标AnalyticDB MySQL集群中符合指定条件的SQL摘要信息。

接口说明

当前服务的接入地址请参见服务接入点。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

adb:DescribeDiagnosisRecords

list

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
DBClusterId	string	是	企业版、基础版或湖仓版集群 ID。说明您可以通过 DescribeDBClusters 接口查看账号下所有集群的详细信息，包括集群 ID。	amv-bp1scs48yc125****
StartTime	string	否	查询开始时间，格式为 Unix 时间戳，单位：毫秒。说明仅支持查看 14 天内的数据。	1632931200000
EndTime	string	否	查询结束时间，格式为 Unix 时间戳，单位：毫秒。说明查询结束时间需晚于查询开始时间。开始时间与结束时间的间隔不能超过 24 小时。	1633017540000
RegionId	string	是	地域 ID。说明您可以调用 DescribeRegions 接口查看 AnalyticDB MySQL 版支持的地域和可用区信息，包括地域 ID。	cn-hangzhou
QueryCondition	string	否	SQL 查询的条件，格式为 JOSN 字符串，包含`Type`、`Value`、`Min`或`Max`等字段。其中`Type` 表示查询维度（当前仅支持 3 个取值：`maxCost`、`status`和`cost`）；`Value`、`Min`或`Max`表示该维度下的查询范围。取值说明： `{"Type":"maxCost","Value":"100"}`：表示查看执行耗时最长的前 100 条 SQL 详情，当前`Value`的取值仅支持设置为 100。 `{"Type":"status","Value":"finished"}`：表示查看已完成的 SQL 详情。您也可以将`Value`设置为`running`或`failed`来查询正在执行或执行失败的 SQL 详情。 `{"Type":"cost","Min":"10","Max":"200"}`：表示查看执行耗时为 10 毫秒~200 毫秒的 SQL 详情，您也可以自定义执行耗时的最大值与最小值，单位：毫秒。	{"Type":"status","Value":"finished"}
Keyword	string	否	按 SQL 语句中包含的关键字过滤。	select
MinPeakMemory	integer	否	SQL 语句的最小峰值内存，单位：Byte。	0
MaxPeakMemory	integer	否	SQL 语句的最大峰值内存，单位：Byte。	89000000
MinScanSize	integer	否	SQL 语句的最小扫描量，单位：Byte。	0
MaxScanSize	integer	否	目标 SQL 的最大扫描量，单位：Byte。	1024000000
ResourceGroup	string	否	SQL 语句所属的资源组。说明您可以调用 DescribeDiagnosisDimensions 接口查看符合指定检索条件的 SQL 语句所属的资源组、数据库名、用户名以及访问源地址信息。	user_default
UserName	string	否	执行 SQL 语句的用户名。您可以调用 DescribeDiagnosisDimensions 接口查看符合指定检索条件的 SQL 语句所属的资源组、数据库名、用户名以及访问源地址信息。	test_user
Database	string	否	执行 SQL 语句的数据库。说明您可以调用 DescribeDiagnosisDimensions 接口查看符合指定检索条件的 SQL 语句所属的资源组、数据库名、用户名以及访问源地址信息。	adb_demo
ClientIp	string	否	访问源地址。说明您可以调用 DescribeDiagnosisDimensions 接口查看符合指定检索条件的 SQL 语句所属的资源组、数据库名、用户名以及访问源地址信息。	59.82.XX.XX
Order	string	否	根据指定字段对 SQL 语句进行排序，格式为 JSON，是一个有序 JSON 数组，按输入数组的顺序进行复合排序，包含`Field`和`Type`两个字段，例如`[{"Field":"StartTime", "Type": "desc" }]`。其中： `Field`表示需要排序的字段名，支持如下字段： `StartTime`：执行开始时间。 `Status`：执行状态。 `UserName`：用户名称。 `Cost`：执行耗时。 `PeakMemory`：峰值内存。 `ScanSize`：扫描数据量。 `Database`：数据库名称。 `ClientIp`：访问源地址. `ResourceGroup`：资源组。 `QueueTime`：排队耗时。 `OutputRows`：输出行数。 `OutputDataSize`：输出数据量。 `ResourceCostRank`：SQL 内部算子的耗时排名（仅当`QueryCondition`取值为`{"Type":"status","Value":"running"}`时，支持使用该字段）。 `Type`表示排序类型，支持如下取值（取值均不区分大小写）： `Desc`：降序。 `Asc`：升序。	[{"Field":"StartTime", "Type": "desc" }]
PageNumber	integer	否	页码，取值为：大于 0 且不超过 Integer 数据类型的最大值，默认值为 1。	1
PageSize	integer	否	每页记录数，取值： 30（默认值） 50 100	30
Lang	string	否	设置下载文件的文件标题以及部分错误信息的语言，支持如下语言： zh：简体中文（默认语言）。 en：英文。 ja：日文。 zh-tw：繁体中文。	zh
PatternId	string	否	SQL Pattern 的 ID。	5575924945138******

返回参数

名称	类型	描述	示例值
	object
PageNumber	integer	页码，取值为大于 0 且不超过 Integer 数据类型的最大值。默认值为 1。	1
PageSize	integer	每页记录数，取值： 30（默认值） 50 100	30
TotalCount	integer	总记录数。	1
Querys	array<object>	SQL 语句详情列表。
	array<object>	列表。
SQL	string	SQL 语句详情。说明出于性能考虑，当前 SQL 语句最长支持显示 5120 个字符，超出限制的 SQL 语句会被截断。您可以调用 DownloadDiagnosisRecords 接口下载符合指定条件的 SQL 语句的摘要信息，包括完整的 SQL 语句。	SELECT count(*)\nFROM nation
SQLTruncatedThreshold	integer	SQL 语句的截断阈值，固定为 5120 个字符。超过该长度的 SQL 语句会被截断。	5120
Status	string	SQL 语句的状态，取值为： running：执行中。 finished：已完成。 failed：执行失败。	finished
OutputDataSize	integer	返回数据量，单位：Byte。	9
Cost	integer	查询的总耗时。单位：毫秒。说明该耗时指标是`QueuedTime`、`TotalPlanningTime`和`ExecutionTime`三个耗时指标的累加值。	10
OutputRows	integer	返回行数。	1
RcHost	string	执行 SQL 语句的 AnalyticDB MySQL 前端节点 IP 和端口信息。	10.0.XX.XX:3004
ScanSize	integer	扫描数据量，单位：Byte。	9
ProcessId	string	查询 ID。	2021093000414401000000023503151******
StartTime	integer	SQL 语句的执行开始时间，格式为 Unix 时间戳，单位：毫秒。	1632933704000
SQLTruncated	boolean	查询结果的长度是否超过阈值（即是否被截断），取值说明： true：查询结果的长度超过阈值。 false：查询结果的长度未超过阈值。	false
Database	string	执行 SQL 语句的数据库名称。	adb_demo
ScanRows	integer	扫描行数。	1
ResourceCostRank	integer	SQL 语句内部算子的耗时排名。说明仅状态为执行中，即`Status`取值为`running`的 SQL 语句支持返回该字段。	1
ClientIp	string	访问源地址。	59.82.XX.XX
PeakMemory	integer	峰值内存，单位：Byte。	16648
QueueTime	integer	查询执行前的排队时间，单位：毫秒（ms）。	6
ResourceGroup	string	SQL 语句所属的资源池。	user_default
UserName	string	执行 SQL 语句的用户名。	test_user
ExecutionTime	integer	查询执行的耗时，单位：毫秒（ms）。	6
TotalPlanningTime	integer	生成执行计划的耗时，单位：毫秒（ms）。	4
EtlWriteRows	integer	ETL 任务写表的行数。	0
TotalStages	integer	查询生成的总 Stage 数量。	2
QueryProperties	array<object>	当前查询最终生效的属性列表。说明常用属性列表，可以参考官方文档，Config 和 Hint 配置参数。
	object	属性键值描述。
Name	string	属性名称。	max_select_items_count
Value	string	属性值。	1024
PatternId	string	SQL Pattern 的 ID。说明您可以调用 DescribePatternPerformance 接口查看指定时间内该 SQLPattern 执行的详细指标。	-5575924945138******
RequestId	string	请求 ID。	7F88BEFA-CF0B-5C95-8BB1-92EC9F09E40D

示例

正常返回示例

JSON格式

{
  "PageNumber": 1,
  "PageSize": 30,
  "TotalCount": 1,
  "Querys": [
    {
      "SQL": "SELECT count(*)\\nFROM nation",
      "SQLTruncatedThreshold": 5120,
      "Status": "finished",
      "OutputDataSize": 9,
      "Cost": 10,
      "OutputRows": 1,
      "RcHost": "10.0.XX.XX:3004",
      "ScanSize": 9,
      "ProcessId": "2021093000414401000000023503151******",
      "StartTime": 1632933704000,
      "SQLTruncated": false,
      "Database": "adb_demo",
      "ScanRows": 1,
      "ResourceCostRank": 1,
      "ClientIp": "59.82.XX.XX",
      "PeakMemory": 16648,
      "QueueTime": 6,
      "ResourceGroup": "user_default",
      "UserName": "test_user",
      "ExecutionTime": 6,
      "TotalPlanningTime": 4,
      "EtlWriteRows": 0,
      "TotalStages": 2,
      "QueryProperties": [
        {
          "Name": "max_select_items_count",
          "Value": "1024"
        }
      ],
      "PatternId": "-5575924945138******"
    }
  ],
  "RequestId": "7F88BEFA-CF0B-5C95-8BB1-92EC9F09E40D"
}

错误码

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

变更历史

更多信息，参考变更详情。