调用DescribeProcessList接口查看实例正在运行的查询。

调试

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

请求参数

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

系统规定参数,取值:DescribeProcessList。

DBClusterId String am-bp1xxxxxxxx47

实例ID。

ShowFull Boolean true

指定是否展示完整的SQL语句。默认值False。

  • True:展示完整的SQL语句。
  • False:只展示SQL语句的前100个字符。
RunningTime Integer 5

按运行时间过滤,展示大于该运行时间的查询。单位:秒。

User String test

按用户名过滤。

Keyword String select

按SQL语句中包含的关键字过滤。

Order String [ { "Field":"Time", "Type":"Desc" }, { "Field":"User", "Type":"Asc" } ]

按指定字段排序,json格式:JSON数组,有序,按顺序输入排列字段和升降序类型:

如:


[

    {

        "Field":"Time",

        "Type":"Desc"

    },

    {

        "Field":"User",

        "Type":"Asc"

    }

]

其中 Field表示需要排序的字段名,支持Time,User,Host,DB。

Type表示排序类型 Desc为降序,Asc为升序

PageSize Integer 30

每页记录数,取值:

  • 30;
  • 50;
  • 100;

默认值:30。

PageNumber Integer 1

页码,取值为:大于0且不超过Integer数据类型的最大值,默认值为1。

返回数据

名称 类型 示例值 描述
Items Array of Process

任务列表。

Process
Command String SELECT

命令类型:INSERT、SELECT。

DB String adb_demo

数据库名。

Host String 192.168.XX.XX:12308

发起查询的IP地址。

Id Integer 49104

工作线程ID。

Info String select * from sbtest1,sbtest2,sbtest3,sbtest4

正在运行的SQL语句,默认返回前100字符。当传入参数ShowFull为True时,显示全文。

ProcessId String 202011191048151921681492420315100****

任务的唯一标识,KILL PROCESS时使用。

StartTime String 2020-11-19T02:48:15Z

任务的开始时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

Time Integer 11

查询任务已运行时间。单位:秒。

User String test

用户名。

PageNumber String 1

页码。

PageSize String 30

总页数。

RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。

TotalCount String 1

总记录数。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeProcessList
&DBClusterId=am-bp1xxxxxxxx47
&<公共请求参数>

正常返回示例

XML 格式

<TotalCount>1</TotalCount>
<PageSize>30</PageSize>
<RequestId>1AD222E9-E606-4A42-BF6D-8A4442913CEF</RequestId>
<PageNumber>1</PageNumber>
<Items>
    <Process>
        <User>test</User>
        <Command>SELECT</Command>
        <StartTime>2020-11-19T02:48:15Z</StartTime>
        <Time>11</Time>
        <Host>192.168.XX.XX:12308</Host>
        <ProcessId>202011191048151921681492420315100****</ProcessId>
        <Id>49104</Id>
        <Info>select * from sbtest1,sbtest2,sbtest3,sbtest4</Info>
        <DB>adb_demo</DB>
    </Process>
</Items>

JSON 格式

{
    "TotalCount": 1,
    "PageSize": 30,
    "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
    "PageNumber": 1,
    "Items": {
        "Process": {
            "User": "test",
            "Command": "SELECT",
            "StartTime": "2020-11-19T02:48:15Z",
            "Time": 11,
            "Host": "192.168.XX.XX:12308",
            "ProcessId": "202011191048151921681492420315100****",
            "Id": 49104,
            "Info": "select * from sbtest1,sbtest2,sbtest3,sbtest4",
            "DB": "adb_demo"
        }
    }
}

错误码

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

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