擷取非同步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"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。