All Products
Search
Document Center

Data Management:ListDBTaskSQLJobDetail

Last Updated:Oct 21, 2024

Queries the details of an SQL task.

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

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
JobIdlongYes

The ID of the SQL task. You can call the ListDBTaskSQLJob operation to query the SQL task ID.

1276****
PageNumberlongNo

The number of the page to return.

1
PageSizelongNo

The number of entries to return on each page.

20
TidlongNo

The ID of the tenant. You can call the GetUserActiveTenant operation to query the tenant ID.

3***

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

The ID of the request.

3F044E33-FE09-58F1-8C61-A0F612EC****
Successboolean

Indicates whether the request is successful. Valid values:

  • true: The request is successful.
  • false: The request fails.
true
ErrorMessagestring

The error message that is returned.

JobId is mandatory for this action.
ErrorCodestring

The error code that is returned.

MissingJobId
DBTaskSQLJobDetailListarray<object>

The details of SQL tasks.

DBTaskSQLJobDetailobject
JobDetailIdlong

The ID of the details of the SQL task.

24723****
CurrentSqlstring

The SQL statement that was executed in the SQL task.

update a set id = 1 where id = 1;
ExecuteCountlong

The number of times that the SQL statement was executed.

1
JobIdlong

The ID of the SQL task.

1276****
DbIdlong

The ID of the physical database.

1988****
Logicboolean

Indicates whether the database is a logical database. Valid values:

  • true: The database is a logical database.
  • false: The database is a physical database.
false
Skipboolean

Indicates whether the SQL statement was skipped. Valid values:

  • true: The SQL statement was skipped.
  • false: The SQL statement was not skipped.
false
SqlTypestring

The type of the SQL statement, such as DELETE, UPDATE, or ALTER_TABLE.

CREATE_TABLE
Statusstring

The status of the SQL task. Valid values:

  • INIT: The SQL task was initialized.
  • PENDING: The SQL task waited to be run.
  • BE_SCHEDULED: The SQL task waited to be scheduled.
  • FAIL: The SQL task failed.
  • SUCCESS: The SQL task was successful.
  • PAUSE: The SQL task was paused.
  • DELETE: The SQL task was deleted.
  • RUNNING: The SQL task was being run.
SUCCESS
Logstring

The details of the operational log.

log_info
StartTimestring

The point in time when the SQL task started.

2021-12-16 00:00:00
EndTimestring

The point in time when the SQL task ended.

2021-12-16 00:00:01
TimeDelaylong

The duration of the SQL task. Unit: milliseconds.

38
AffectRowslong

The number of rows affected by the SQL task.

0
TotalCountlong

The total number of SQL tasks.

1

Examples

Sample success responses

JSONformat

{
  "RequestId": "3F044E33-FE09-58F1-8C61-A0F612EC****",
  "Success": true,
  "ErrorMessage": "JobId is mandatory for this action.",
  "ErrorCode": "MissingJobId",
  "DBTaskSQLJobDetailList": [
    {
      "JobDetailId": 0,
      "CurrentSql": "update a set id = 1 where id  = 1;",
      "ExecuteCount": 1,
      "JobId": 0,
      "DbId": 0,
      "Logic": false,
      "Skip": false,
      "SqlType": "CREATE_TABLE",
      "Status": "SUCCESS",
      "Log": "log_info",
      "StartTime": "2021-12-16 00:00:00",
      "EndTime": "2021-12-16 00:00:01",
      "TimeDelay": 38,
      "AffectRows": 0
    }
  ],
  "TotalCount": 1
}

Error codes

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

Change history

Change timeSummary of changesOperation
No change history