调用GetFullRequestSampleByInstanceId接口,按照SQL ID查询数据库实例SQL洞察结果中的SQL样本数据,最大返回20条样本数据。

SQL洞察功能可对SQL进行健康情况诊断、性能问题排查,详情请参见SQL洞察

  • 支持的数据库引擎请参见SQL洞察
  • 在使用SDK调用DAS服务时,需要将地域指定为cn-shanghai。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetFullRequestSampleByInstanceId

系统规定参数。取值:GetFullRequestSampleByInstanceId

UserId String 196278346919****

用户ID,即创建数据库实例的阿里云主账号ID。

说明 非必填,输入目标数据库实例ID后,在调用API接口时,系统会自动获取用户ID。
InstanceId String rm-2ze8g2am97624****

实例ID。

SqlId String 651b56fe9418d48edb8fdf0980ec****

SQL ID。

Start Long 1660097421000

查询开始时间,格式为Unix时间戳,单位为毫秒。

说明 查询开始时间需要在数据库实例SQL洞察存储时长范围内,最大不能早于当前时间90天。
End Long 1660104621000

查询结束时间,格式为Unix时间戳,单位为毫秒。

说明 查询结束时间需晚于查询开始时间,且查询开始时间和查询结束时间的间隔不能小于1小时。
Role String polarx_cn

PolarDB-X 2.0数据库实例节点信息。

  • polarx_cn:计算节点。
  • polarx_en:数据节点。

返回数据

名称 类型 示例值 描述
Message String Successful

请求返回消息。

说明 请求成功时该参数返回Successful,请求失败时会返回请求异常信息(如错误码等)。
RequestId String 0A74B755-98B7-59DB-8724-1321B394****

请求ID。

Data Array of Item

返回数据

Timestamp Long 1660100753556

执行SQL的时间,格式为Unix时间戳,单位为毫秒。

SqlId String 651b56fe9418d48edb8fdf0980ec****

SQL ID。

Sql String select * from testdb01 where ****

SQL样本。

Database String dbtest

数据库名。

Rt double 0.409789

执行耗时,单位为秒。

User String testuser

执行SQL的用户名称。

LockWaitTime double 0.0137

锁等待时长,单位为秒。

LogicalRead double 165848

逻辑读。

PhysicalSyncRead double 0

物理同步读取。

PhysicalAsyncRead double 0

物理异步读取。

RowsExamined Long 2048576

总扫描行数。

说明 目前支持该字段的数据库:RDS MySQL、RDS PostgreSQL、PolarDB MySQL。
RowsReturned Long 14

返回行数。

OriginHost String 172.17.XX.XX

访问来源。

ScanRows Long 0

扫描行数。

UpdateRows Long 0

更新行数。

SqlType String SELECT

SQL语句的类型,取值包括:SELECTINSERTUPDATEDELETELOGINLOGOUTMERGEALTERCREATEINDEXDROPINDEXCREATEDROPSETDESCREPLACECALLBEGINDESCRIBEROLLBACKFLUSHUSESHOWSTARTCOMMITRENAME

Scnt Long 0

PolarDB-X 2.0计算节点(CN)的DN请求数。

Rows Long 0

PolarDB-X 2.0计算节点(CN)的更新/返回行数。

Frows Long 0

PolarDB-X 2.0计算节点(CN)的拉取行数。

Code Long 200

返回的状态码。

Success Boolean true

请求是否执行成功:

  • true:执行成功。
  • false:执行失败。

示例

请求示例

http(s)://das.cn-shanghai.aliyuncs.com/?Action=GetFullRequestSampleByInstanceId
&UserId=196278346919****
&InstanceId=rm-2ze8g2am97624****
&SqlId=651b56fe9418d48edb8fdf0980ec****
&Start=1660097421000
&End=1660104621000
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GetFullRequestSampleByInstanceIdResponse>
    <Message>Successful</Message>
    <RequestId>0A74B755-98B7-59DB-8724-1321B394****</RequestId>
    <Data>
        <Timestamp>1660100753556</Timestamp>
        <SqlId>651b56fe9418d48edb8fdf0980ec****</SqlId>
        <Sql>select * from testdb01 where ****</Sql>
        <Database>dbtest</Database>
        <Rt>0.409789</Rt>
        <User>testuser</User>
        <LockWaitTime>0.0137</LockWaitTime>
        <LogicalRead>165848</LogicalRead>
        <PhysicalSyncRead>0</PhysicalSyncRead>
        <PhysicalAsyncRead>0</PhysicalAsyncRead>
        <RowsExamined>2048576</RowsExamined>
        <RowsReturned>14</RowsReturned>
        <OriginHost>172.17.XX.XX</OriginHost>
        <ScanRows>0</ScanRows>
        <UpdateRows>0</UpdateRows>
        <SqlType>SELECT</SqlType>
        <Scnt>0</Scnt>
        <Rows>0</Rows>
        <Frows>0</Frows>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</GetFullRequestSampleByInstanceIdResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Message" : "Successful",
  "RequestId" : "0A74B755-98B7-59DB-8724-1321B394****",
  "Data" : [ {
    "Timestamp" : 1660100753556,
    "SqlId" : "651b56fe9418d48edb8fdf0980ec****",
    "Sql" : "select * from testdb01 where ****",
    "Database" : "dbtest",
    "Rt" : 0.409789,
    "User" : "testuser",
    "LockWaitTime" : 0.0137,
    "LogicalRead" : 165848,
    "PhysicalSyncRead" : 0,
    "PhysicalAsyncRead" : 0,
    "RowsExamined" : 2048576,
    "RowsReturned" : 14,
    "OriginHost" : "172.17.XX.XX",
    "ScanRows" : 0,
    "UpdateRows" : 0,
    "SqlType" : "SELECT",
    "Scnt" : 0,
    "Rows" : 0,
    "Frows" : 0
  } ],
  "Code" : 200,
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParams The request parameters are invalid. 请求参数错误

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