非同期 SQL クエリのステータスと結果を取得します。
操作説明
SubmitAsyncSql 操作を使用して SQL リクエストを送信した後、この操作を使用してリクエストの実行ステータスをポーリングできます。ポーリング間隔は 1 秒以上に設定できます。クエリが完了したら、GetAsyncSql 操作を使用して結果をページ単位で取得します。
今すぐお試しください
テスト
RAM 認証
リクエスト構文
GET /asyncsql/{queryId} HTTP/1.1
パスパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| queryId |
string |
任意 |
非同期 SQL クエリの ID。この ID は、SQL のライフサイクルを通じて固定されます。 |
690C4F2A16FBD65C40000484_14 |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| project |
string |
任意 |
プロジェクトの名前。 |
sls-demo-project |
| offset |
integer |
任意 |
ページ分割された結果のオフセット。 |
0 |
| line |
integer |
任意 |
1 ページあたりに返す結果の数。最大値は 1000 です。 |
100 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
| AsyncSqlResponseData |
応答本文のデータ形式。これは protobuf フォーマットに対応します。 |
error_code および error_message パラメーターは、state パラメーターが FAILED の場合にのみ有効です。
例
成功レスポンス
JSONJSON
{
"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"
}
エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。