DescribeSlowLogRecords

查询PolarDB-X计算节点和存储节点的慢SQL明细。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String DescribeSlowLogRecords

系统规定参数。取值:DescribeSlowLogRecords

PageSize Integer 30

分页每页大小。默认值:100。

限制:最大支持一次返回100条记录。

Page Integer 1

页码。默认值:1。

StartTime String 2024-10-09T02:26

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

EndTime String 2024-11-22T02:22Z

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

DBInstanceName String pxc-bjxxxxxxxx

实例名称。

DBNodeIds String pxc-i-mezcj4ejdz

节点ID。支持传入多个节点ID,多个ID间用英文逗号(,)分隔。查询存储节点的时候,该项为必填项。

CharacterType String polarx_cn

节点类型。

RegionId String cn-hangzhou

实例所属地域ID。

DBName String testdb

数据库名。

返回数据

名称

类型

示例值

描述

RequestId String C458B1E8-1683-3645-B154-6BA32080EEA

Id of the request

DBInstanceId String pxc-********

实例ID。

PageNumber String 1

当前查询的页码。

PageRecordCount String 30

分页每页大小。

TotalCount String 3

总条目数。

Items Array of SQLSlowlog

慢日志明细列表。

SQLHash String c8df07e5d45cd68da8b4771c2016e20b

慢日志统计里的 SQL 语句唯一标识符

SQLText String select * from test

SQL语句。

QueryStartTime String 2024-11-22T02:22:22.444Z

时间戳,格式:YYYY-MM-ddTHH:mm.ss.SSSZ(UTC时间)。

  • CN慢日志,该字段表示执行开始时间。
  • DN慢日志,该字段表示执行完成时间。
QueryTime String 3.000

SQL语句执行时长,单位:秒(s)。

QueryTimeMS String 3000.000

SQL语句执行时长,单位:秒(ms)。

LockTimeMS String 1

锁定时长。单位:毫秒(ms)。仅DN有该字段。

ParseRowCounts String 10

扫描行数。仅DN有该字段。

ReturnRowCounts String 20

返回行数。仅DN有该字段。

HostAddress String ****[****] @ [1XX.XX.XX.XX]

连接数据库的客户端名称及地址。

DBName String dcdev

数据库名称。

CNname String pxc-i-xxxx

计算节点名称。仅CN有该字段。

Extension String tddl:5.4.19-20240927

拓展字段。仅CN有该字段。

Fail String 0

是否失败。仅CN有该字段。

InsName String pxc-xdb-s-xxxx

实例名。仅DN有该字段。

IsBind String 0

是否为Prepare模式。仅CN有该字段。

WT String TP

负载类型。仅CN有该字段。

Params String ["1"]

Prepare模式下的参数。仅CN有该字段。

Frows String 1

拉取行数。仅CN有该字段。

Rows String 1

影响/返回行数。仅CN有该字段。

SCNT String 1

物理SQL数。仅CN有该字段。

SqlType String select

SQL类型。仅CN有该字段。

TooLong String 0

是否过长。仅CN有该字段。

TraceId String 17a5c5c840006000

跟踪ID。仅CN有该字段。

TransactionPolicy String XA

事务策略。仅CN有该字段。

TrxId String 17a5c5c840006000

事务ID。仅CN有该字段。

TemplateId String af33ffee

内核模板ID。仅CN有该字段。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeSlowLogRecords
&PageSize=30
&Page=1
&StartTime=2024-10-09T02:26
&EndTime=2024-11-22T02:22Z
&DBInstanceName=pxc-bjxxxxxxxx
&DBNodeIds=pxc-i-mezcj4ejdz
&CharacterType=polarx_cn
&RegionId=cn-hangzhou
&DBName=testdb
&公共请求参数

正常返回示例

XML格式

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

<DescribeSlowLogRecordsResponse>
    <RequestId>C458B1E8-1683-3645-B154-6BA32080EEA</RequestId>
    <DBInstanceId>pxc-********</DBInstanceId>
    <PageNumber>1</PageNumber>
    <PageRecordCount>30</PageRecordCount>
    <TotalCount>3</TotalCount>
    <Items>
        <SQLHash>c8df07e5d45cd68da8b4771c2016e20b</SQLHash>
        <SQLText>select * from test </SQLText>
        <QueryStartTime>2024-11-22T02:22:22.444Z</QueryStartTime>
        <QueryTime>3.000</QueryTime>
        <QueryTimeMS>3000.000</QueryTimeMS>
        <LockTimeMS>1</LockTimeMS>
        <ParseRowCounts>10</ParseRowCounts>
        <ReturnRowCounts>20</ReturnRowCounts>
        <HostAddress>****[****] @ [1XX.XX.XX.XX]
</HostAddress>
        <DBName>dcdev</DBName>
        <CNname>pxc-i-xxxx</CNname>
        <Extension>tddl:5.4.19-20240927</Extension>
        <Fail>0</Fail>
        <InsName>pxc-xdb-s-xxxx</InsName>
        <IsBind>0</IsBind>
        <WT>TP</WT>
        <Params>["1"]</Params>
        <Frows>1</Frows>
        <Rows>1</Rows>
        <SCNT>1</SCNT>
        <SqlType>select</SqlType>
        <TooLong>0</TooLong>
        <TraceId>17a5c5c840006000</TraceId>
        <TransactionPolicy>XA</TransactionPolicy>
        <TrxId>17a5c5c840006000</TrxId>
        <TemplateId>af33ffee</TemplateId>
    </Items>
</DescribeSlowLogRecordsResponse>

JSON格式

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

{
  "RequestId" : "C458B1E8-1683-3645-B154-6BA32080EEA",
  "DBInstanceId" : "pxc-********",
  "PageNumber" : "1",
  "PageRecordCount" : "30",
  "TotalCount" : "3",
  "Items" : [ {
    "SQLHash" : "c8df07e5d45cd68da8b4771c2016e20b",
    "SQLText" : "select * from test ",
    "QueryStartTime" : "2024-11-22T02:22:22.444Z",
    "QueryTime" : "3.000",
    "QueryTimeMS" : "3000.000",
    "LockTimeMS" : "1",
    "ParseRowCounts" : "10",
    "ReturnRowCounts" : "20",
    "HostAddress" : "****[****] @ [1XX.XX.XX.XX]\n",
    "DBName" : "dcdev",
    "CNname" : "pxc-i-xxxx",
    "Extension" : "tddl:5.4.19-20240927",
    "Fail" : "0",
    "InsName" : "pxc-xdb-s-xxxx",
    "IsBind" : "0",
    "WT" : "TP",
    "Params" : "[\"1\"]",
    "Frows" : "1",
    "Rows" : "1",
    "SCNT" : "1",
    "SqlType" : "select",
    "TooLong" : "0",
    "TraceId" : "17a5c5c840006000",
    "TransactionPolicy" : "XA",
    "TrxId" : "17a5c5c840006000",
    "TemplateId" : "af33ffee"
  } ]
}

错误码

HttpCode

错误码

错误信息

描述

400 InvalidStartTime.Malformed The specified parameter StartTime is not valid. 开始时间格式非法
400 InvalidDBInstance.NotFound The specified DB instance does not exist or is not supported. 指定实例不存在
404 InvalidDBInstanceId.NotFound The specified DBInstanceId does not exist. 实例ID不存在

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