调用GetQueryResult API轮询获取异步查询结果-数据湖构建-阿里云

获取数据探索查询结果。

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dlf:GetQueryResult

get

*全部资源

*

无

请求语法

GET /webapi/query/getQueryResult HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
QueryId	string	否	查询 ID。说明您可以调用接口 SubmitQuery 获取查询 ID。	Q-41676378709440CE
PageNumber	integer	否	页码。	1
PageSize	integer	否	每页大小，最大值为 1000。	100

返回参数

名称	类型	描述	示例值
	object	获得查询结果。	{ "data" : }
Status	string	查询状态。枚举值： AVAILABLE : 可用 CANCELLED : 已取消 RUNNING : 运行中 CANCELLING : 取消中 WAITING : 等待中 ERROR : 错误	AVAILABLE
ResultTmpTable	string	结果临时表，暂不可用。	table
Owner	integer	创建者主账号 uid。	229167306180609***
ErrorMessage	string	查询的错误信息。	Table or view not found:
Progress	integer	查询进度，0~100 之间。	99
Success	boolean	请求是否成功。取值如下： true：成功。 false：失败。	true
Schema	string	查询结果的表头字段和类型.仅当状态为 AVAILABLE 时返回。	[{"name":"id","type":"INT"},{"name":"student_name","type":"VARCHAR"}]
ResultTmpDb	string	结果临时库，暂不可用。	db
GmtModified	string	查询结果更新时间。	2022-05-09 16:19:09
JobCompleted	boolean	查询是否已经完成，false 代表需要继续轮询本接口。	true
RowCount	integer	结果总行数，仅当状态为 AVAILABLE 时返回。	100
RegionId	string	地域 ID。	cn-hangzhou
EndTime	string	查询完成时间。	2022-05-09 16:19:09
StartTime	string	查询开始时间。	2022-05-09 16:18:09
RequestId	string	请求 ID。	1D2BCFBA-7639-59A9-817B-944EC1339279
Rows	string	返回结果信息，仅当状态为 AVAILABLE 时返回。内容用一个二维 JSON 数组表示。	[[10,"Tom"],[11,"Jerry"]]
Logs	string	运行日志。	["this is log"]
GmtCreate	string	查询创建时间。	2022-05-09 16:18:09
Duration	integer	已运行时间，单位是毫秒。	8000
Sql	string	原始执行的 sql 语句。	select * from db.student
RowCountOverLimit	boolean	结果总行数是否超过最大值。	false
Id	string	查询 ID。	Q-41676378709440CE
TotalBytesProcessed	integer	总共扫描数据量，单位字节。	1024

示例

正常返回示例

JSON格式

{
  "Status": "AVAILABLE",
  "ResultTmpTable": "table",
  "Owner": 0,
  "ErrorMessage": "Table or view not found:",
  "Progress": 99,
  "Success": true,
  "Schema": "[{\"name\":\"id\",\"type\":\"INT\"},{\"name\":\"student_name\",\"type\":\"VARCHAR\"}]",
  "ResultTmpDb": "db\n",
  "GmtModified": "2022-05-09 16:19:09",
  "JobCompleted": true,
  "RowCount": 100,
  "RegionId": "cn-hangzhou",
  "EndTime": "2022-05-09 16:19:09",
  "StartTime": "2022-05-09 16:18:09",
  "RequestId": "1D2BCFBA-7639-59A9-817B-944EC1339279",
  "Rows": "[[10,\"Tom\"],[11,\"Jerry\"]]",
  "Logs": "[\"this is log\"]",
  "GmtCreate": "2022-05-09 16:18:09",
  "Duration": 8000,
  "Sql": "select * from db.student",
  "RowCountOverLimit": false,
  "Id": "Q-41676378709440CE\n",
  "TotalBytesProcessed": 1024
}

错误码

HTTP status code	错误码	错误信息	描述
400	Query.ResultExpired	Query result cache expired, please export result in history query

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

变更历史

更多信息，参考变更详情。