Tous les produits
Search
Centre de documentation

:GetAsyncSql

Dernière mise à jour :Aug 07, 2026

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

Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

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.