调用DescribeProcessList接口查看AnalyticDB MySQL集群正在运行的查询。

调试

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

请求参数

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

系统规定参数。取值：DescribeProcessList。

DBClusterId String 是 am-bp11q28kvl688****

集群ID。
ShowFull Boolean 否 True

是否展示完整的SQL语句。取值说明：

  • True：展示完整的SQL语句。
  • False：只展示SQL语句的前100个字符。
说明 默认值False。
RunningTime Integer 否 5

按运行时间过滤，展示大于该运行时间的查询。单位：秒。
User String 否 test

按用户名过滤。
Keyword String 否 SELECT

过滤关键字，目前仅支持过滤SELECT。

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

按指定字段排序，JSON格式，[{"Field":"Time","Type":"Desc" },{ "Field":"User", "Type":"Asc" }]，取值说明：

  • Field：需要排序的字段名，支持Time，User，Host，DB字段。
  • Type：排序类型，Desc为降序，Asc为升序。
PageSize Integer 否 30

每页记录数，取值：

  • 30（默认值）
  • 50
  • 100
PageNumber Integer 否 1

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

返回数据

名称 类型 示例值 描述
TotalCount String 1

总记录数。
PageSize String 30

总页数。
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。
PageNumber String 1

页码。
Items Array of Process

任务列表。
Process
StartTime String 2020-11-19T02:48:15Z

任务的开始时间，UTC时间，格式：yyyy-MM-ddTHH:mm:ssZ。
Time Integer 11

查询任务已运行时间。单位：秒。
ProcessId String 202011191048151921681492420315100****

任务的唯一标识，KILL PROCESS时使用。
Host String 192.168.XX.XX:12308

发起查询的IP地址。
DB String adb_demo

数据库名。
Command String SELECT

命令类型，仅支持SELECT类型。
User String test

用户名。
Id Integer 49104

工作线程ID。
Info String select * from sbtest1,sbtest2,sbtest3,sbtest4

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

示例

请求示例

http(s)://adb.aliyuncs.com/?Action=DescribeProcessList
&DBClusterId=am-bp11q28kvl688****
&ShowFull=True
&RunningTime=5
&User=test
&Keyword=SELECT
&Order=[ { "Field":"Time","Type":"Desc" },  { "Field":"User", "Type":"Asc" }]
&PageSize=30
&PageNumber=1
&公共请求参数

正常返回示例

XML格式 

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

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

JSON格式 

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

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

错误码

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

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