文档中心

数据库工作台

SQL 任务

DataGetCommandSetResult

DataGetCommandSetResult

调用 DataGetCommandSetResult 接口查询异步执行命令集的执行结果。

注意

命令集未执行完成时，无法获取执行结果。

命令集执行完成后，命令集的执行结果只保留 5 分钟，请及时调用 DataGetCommandSetResult 接口获取执行结果数据。

命令集执行完成后，只能调用一次 DataGetCommandSetResult 接口查询执行结果。如果再次调用接口查询，5 分钟内则提示重复查询；5 分钟后则提示无法获取执行结果。

前提条件

已调用 DataExecCommandSetAsync 接口异步执行命令集。

请求类型

同步请求。

请求参数

名称	类型	是否必选	示例值	描述
CommandSetId	String	是	178887541272244****	命令集 ID。说明调用 DataExecCommandSetAsync 接口，获取命令集 ID。
FilterType	String	否	Success	命令集中 SQL 语句的执行状态，取值如下： Success：表示查询命令集中执行成功的 SQL 语句。 Failed：表示查询命令集中执行失败的 SQL 语句。 Cancel：表示查询取消执行的命令集。 All：（默认值）表示查询所有的命令集。

返回参数

名称	类型	示例值	描述
Results	Array of Result	[ { "ColumnNames": [ "Database" ], "CommandStr": "show databases;", "ReasonDetail": "", "RowCount": 2, "Rows": [ { "Cells": [ "information_schema" ] }, { "Cells": [ "sys" ] } ], "RunTime": 1715396681000, "State": "Success" } ]	命令集执行结果的集合。详细信息，请参见 Result。
FilterType	String	Success	过滤命令集中 SQL 语句执行状态的条件，取值如下： Success：表示查询的是命令集中执行成功的 SQL 语句。 Failed：表示查询的是命令集中执行失败的 SQL 语句。 Cancel：表示查询的是命令集中取消执行的 SQL 语句。 All：表示查询的是命令集中所有 SQL 语句。

请求示例

返回示例

命令集执行完成后，5 分钟内首次调用接口查询的返回结果示例如下。

{
"ResponseMetadata": {
"RequestId": "2024051116125243C401426335B0927AD5-3223f0",
"Action": "DataGetCommandSetResult",
"Version": "2018-01-01",
"Service": "dbw",
"Region": "cn-beijing"
},
"Result": {
"FilterType": "All",
"Results": [
{
"ColumnNames": [
"Database"
],
"CommandStr": "show databases;",
"ReasonDetail": "",
"RowCount": 2,
"Rows": [
{
"Cells": [
"information_schema"
]
},
{
"Cells": [
"sys"
]
}
],
"RunTime": 1715396681000,
"State": "Success"
}
]
}
}

命令集执行未完成，或命令集执行完成后，时间超过 5 分钟，返回的结果示例如下。

{
"ResponseMetadata": {
"RequestId": "20250811155627DA66FE54BA3182023484-16e659",
"Action": "DataGetCommandSetResult",
"Version": "2018-01-01",
"Service": "dbw",
"Region": "cn-beijing"
},
"Result": {
"Results": [
{
"ColumnNames": [],
"CommandStr": "",
"ReasonDetail": "No results found now, pls wait commands been executed or command set results have been retrieved or expired, you cannot fetch it again.",
"RowCount": 0,
"Rows": [],
"RunTime": 0,
"RunningInfo": {
"Info": "",
"IsOnlineDDL": false,
"Progress": "",
"TaskID": ""
},
"State": "Success"
}
]
}
}

命令集执行完成后，5 分钟内再次调用接口查询返回的结果示例如下。

"Results": [
{
"ColumnNames": [],
"CommandStr": "",
"ReasonDetail": "CommandSet Results have been retrieved. To fetch the data, please rerun DataExecCommandSetAsync",
"RowCount": 0,
"Rows": [],
"RunTime": 0,
"RunningInfo": {
"Info": "",
"IsOnlineDDL": false,
"Progress": "",
"TaskID": ""
},
"State": "Success"
}
]

错误码

更多详情，请参见错误码。

最近更新时间：2026.01.14 11:06:05

这个页面对您有帮助吗？

有用

有用

无用

无用