获取异步SQL的状态以及结果
接口说明
通过 SubmitAsyncSql 接口提交 SQL 请求后，后续可以通过本接口来轮询请求的执行状态（建议轮询周期设置为不低于 1s）。当接口执行成功后，可以通过 GetAsyncSql 接口以分页的形式来拉去结果。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
GET /asyncsql/{queryId} HTTP/1.1路径参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| queryId |
string |
否 |
异步 SQL 对应的 ID（整个 SQL 生命周期内固定） |
690C4F2A16FBD65C40000484_14 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| project |
string |
否 |
sls 的 project 名称 |
sls-demo-project |
| offset |
integer |
否 |
分页结果的 offset |
0 |
| line |
integer |
否 |
分页结果的 page 大小，最大支持 1000 |
100 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
| AsyncSqlResponseData |
body 中返回的数据格式（对应 protobuf 格式） |
仅当结果中 state 为 FAILED 时，结果集中的 error_code 和 error_message 才有意义。
示例
正常返回示例
JSON格式
{
"id": "690C4F2A16FBD65C40000484_14",
"state": "FINISHED",
"AsyncSqlMetaPB": {
"result_rows": 12000,
"processed_rows": 10000000,
"elapsed_milli": 30000,
"cpu_sec": 0.2,
"cpu_cores": 10,
"progress": "Complete",
"keys": [
"[\"name\", \"age\", \"gender\"]"
]
},
"rows": [
[
"[\"Jimmy\", \"20\", \"male\"]"
]
],
"error_code": "InvalidQuery",
"error_message": "line 37:14: Column 'xyz' cannot be resolved"
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。