Obtient l'état et les résultats d'une requête SQL asynchrone.
Description de l'opération
Après avoir soumis une requête SQL à l'aide de l'opération SubmitAsyncSql, vous pouvez utiliser cette opération pour interroger l'état d'exécution de la requête. Vous pouvez définir l'intervalle d'interrogation à 1 seconde ou plus. Une fois la requête terminée, utilisez l'opération GetAsyncSql pour récupérer les résultats par pages.
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
Syntaxe de la requête
GET /asyncsql/{queryId} HTTP/1.1
Paramètres de chemin
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| queryId |
string |
Non |
L'identifiant de la requête SQL asynchrone. Cet identifiant est fixe tout au long du cycle de vie de la requête SQL. |
690C4F2A16FBD65C40000484_14 |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| project |
string |
Non |
Le nom du projet. |
sls-demo-project |
| offset |
integer |
Non |
Le décalage pour les résultats paginés. |
0 |
| line |
integer |
Non |
Le nombre de résultats à renvoyer par page. La valeur maximale est de 1000. |
100 |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
| AsyncSqlResponseData |
Le format de données du corps de la réponse. Cela correspond au format protobuf. |
Les paramètres error_code et error_message sont valides uniquement lorsque le paramètre state est FAILED.
Exemples
JSON format
{
"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"
}
Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.