All Products
Search
Document Center

AnalyticDB:ListSlowSQLRecords

Last Updated:Jan 23, 2026

Queries slow SQL queries.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • For mandatory resource types, indicate with a prefix of * .
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
gpdb:ListSlowSQLRecordsget
*DBInstance
acs:gpdb::{#accountId}:dbinstance/{#DBInstanceId}
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
DBInstanceIdstringYes

The cluster ID.

Note You can call the DescribeDBInstances operation to query the information about all AnalyticDB for PostgreSQL instances within a region, including instance IDs.
gp-xxxxxxxxx
DBNamestringNo

The name of the database.

testdb01
UserNamestringNo

The account name.

test_user
StartTimestringNo

The beginning of the time range to query. The time must be in UTC and formatted as yyyy-MM-ddTHH:mmZ.

Defaults to the current time minus 5 minutes.

2024-12-04T16:00:00Z
EndTimestringNo

The end of the time range to query. The time must be in UTC and formatted as yyyy-MM-ddTHH:mmZ. The time must be in UTC. The end time must be later than the start time.

Defaults to the current time.

2024-12-04T17:00:00Z
KeywordstringNo

The search keyword.

SELECT
MinDurationstringNo

The minimum execution duration. Unit: seconds.

10
MaxDurationstringNo

The longest execution duration. Unit: seconds.

600
OrderBystringNo

Sort criteria (JSON string). {"Field":"QueryStartTime","Type":"Desc"}

Field: Specifies the field to sort by.

  • QueryID: Query ID.
  • UserName: The username.
  • DBName: The name of the database.
  • QueryStartTime: The start time.
  • QueryEndTime: The end time.
  • DurationTime: The execution duration of the query.
  • Optimizer.
  • LockWaitTime: The lock waiting time.
  • QueueWaitTime: Time in Queue.
  • CpuTimeMs: CPU time.
  • MemBytes: The memory usage.
  • SpillBytes: Spill File Size.

Type: Sort order.

  • Desc: descending.
  • Asc: ascending.
{"Field":"QueryStartTime","Type":"Desc"}
RegionIdstringNo

The region ID of the instance.

cn-hangzhou
PageSizeintegerNo

The number of entries per page. Valid values:

  • 30
  • 50
  • 100

Default value: 30.

30
PageNumberintegerNo

The number of the page to return. The value must be a positive integer in the range [1, 100]. Default value: 1.

1

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The unique ID of the request.

ABB39CC3-4488-4857-905D-2E4A051D0521
TotalRecordCountinteger

The total number of log entries returned.

2
PageNumberinteger

The page number of the returned page.

1
PageRecordCountinteger

The number of entries per page.

2
Itemsarray<object>

List of slow queries.

itemobject

List of slow queries.

QueryIDstring

The query ID. It is a unique identifier of the query.

7775338456746339025
UserNamestring

The account that initiates the query.

test_user
DBNamestring

The name of the database.

adbpgadmin
SqlTextstring

SQL statements in audit logs.

SHOW COLUMNS FROM `t_project`
QueryStartTimestring

The start time of the query.

2024-12-04T17:00:00Z
QueryEndTimestring

The end time of the query.

2024-12-04T18:00:00Z
DurationTimeinteger

Total execution time in milliseconds.

2000
SqlTruncatedThresholdinteger

The threshold that is used to truncate the SQL statement.

100
SqlTruncatedstring

Indicates whether the SQL statement is truncated. Valid values:

  • true: Truncated.
  • false: Not truncated.
false
Optimizerstring

Execution optimizer.

planner
LockWaitTimeinteger

The total lock wait time (in milliseconds).

1000
QueueWaitTimeinteger

The query queueing time (in milliseconds) in resource groups/queues.

1000
CpuTimeMslong

The total CPU time (in milliseconds) consumed by the query execution.

1000
MemByteslong

The total memory (in bytes) occupied by the query execution.

1000
SpillByteslong

The total size (in bytes) of the files generated by the query.

1000

Examples

Sample success responses

JSONformat

{
  "RequestId": "ABB39CC3-4488-4857-905D-2E4A051D0521",
  "TotalRecordCount": 2,
  "PageNumber": 1,
  "PageRecordCount": 2,
  "Items": [
    {
      "QueryID": 7775338456746339000,
      "UserName": "test_user",
      "DBName": "adbpgadmin",
      "SqlText": "SHOW COLUMNS FROM `t_project`",
      "QueryStartTime": "2024-12-04T17:00:00Z",
      "QueryEndTime": "2024-12-04T18:00:00Z",
      "DurationTime": 2000,
      "SqlTruncatedThreshold": 100,
      "SqlTruncated": false,
      "Optimizer": "planner",
      "LockWaitTime": 1000,
      "QueueWaitTime": 1000,
      "CpuTimeMs": 1000,
      "MemBytes": 1000,
      "SpillBytes": 1000
    }
  ]
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2025-11-05Add OperationView Change Details