全部產品
Search
文件中心

Simple Log Service:GetAsyncSql - 擷取非同步SQL結果

更新時間:Dec 08, 2025

擷取非同步SQL的狀態以及結果

介面說明

通過 SubmitAsyncSql 介面提交 SQL 請求後,後續可以通過本介面來輪詢請求的執行狀態(建議輪詢周期設定為不低於 1s)。當介面執行成功後,可以通過 GetAsyncSql 介面以分頁的形式來拉去結果。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情