获取异步查询结果

版本 4.0.23.6(最新)

获取异步查询结果

返回异步查询任务的结果(如果查询已完成)。

如果查询任务仍在运行或正在等待运行,此函数将返回 204 No Content。

如果查询任务 ID 无效或查询任务的缓存结果已过期,此函数将返回 404 Not Found。

使用 query_task(query_task_id) 检查查询任务的执行状态 仅在查询任务状态达到“完成”时调用 query_task_results。

您还可以同时使用 query_task_multi_results() 检索多个异步查询任务的结果。

SQL 错误处理:

如果查询因 SQL 数据库错误而失败,应如何传达取决于您在 create_query_task() 中请求的 result_format。

对于 json_detail result_format:query_task_results() 将返回 HTTP 状态“200 OK”,而数据库 SQL 错误信息将包含在响应对象的 errors 属性中。“数据”属性将为空。

对于所有其他结果格式:query_task_results() 将返回 HTTP 状态 400 Bad Request,并且一些 db SQL 错误信息会显示在 400 错误响应中,但不如 json_detail.errors 中所述。 这些数据格式只能包含行数据,而错误信息不是行数据。

请求

GET /query_tasks/{query_task_id}/results
数据类型
说明
请求
HTTP 请求
路径
HTTP 路径
展开 HTTPPath 定义...
query_task_id
字符串
查询任务的 ID

响应

200:查询结果。

数据类型
说明
(字符串)
字符串

204:查询未完成

数据类型
说明
(字符串)
字符串

400:错误请求

数据类型
说明
(对象)
消息
字符串
错误详情
文档网址
字符串
文档链接

404:未找到查询任务 ID 或结果已过期。

数据类型
说明
(对象)
消息
字符串
错误详情
文档网址
字符串
文档链接

示例