ES|QL 现在支持通过专门 API 列出、查询异步任务，开发者不用再写循环轮询的方式盲目等待查询执行完成，能直接主动获取任务状态、进度、结果信息，简化长耗时查询的开发逻辑。ES|QL 部分查询，尤其是超大索引、多表关联、复杂聚合的查询，执行耗时很长，如果没有异步任务查询能力，业务代码只能定时反复请求接口，不断判断任务有没有跑完，很容易出现无效请求、超时不好控制、资源浪费的问题。新增的这套异步任务 API，包含任务列表查看、单任务详情查询、任务状态获取能力，提交异步查询之后，拿到任务 ID，随时按需查询，还可以筛选自己名下的任务，清理失效任务，把等待逻辑从盲轮询改成按需查询，代码更稳定，也降低 ES 集群的查询压力。
- 异步任务 API 核心能力清单
- 任务列表查询：分页查看当前用户所有 ES|QL 异步任务，支持按状态、时间筛选
- 单任务详情查询：传入 task_id，查看任务进度、执行状态、报错信息、结果链接
- 任务状态识别：区分排队中、运行中、成功、失败、已取消多种状态
- 任务管理：支持取消正在执行的异步任务
- 结果获取：任务成功后，直接通过接口拿到 ES|QL 查询结果集
- 新旧等待方式对比
- 典型实操流程
| 方式 | 实现逻辑 | 优点 | 缺点 |
|---|---|---|---|
| 旧方案：盲等 + 轮询 | 提交查询，循环定时发起请求，判断是否返回结果 | 适配旧版本 ES，上手简单 | 大量无效请求，集群压力高，超时逻辑难写 |
| 新方案：异步任务查询 API | 提交异步查询拿到 taskId，按需调用任务查询接口 | 按需拉取，减少无效请求，可看进度、可取消 | 需要适配新版 ES 接口，改造原有代码 |
- 提交 ES|QL 异步查询请求，接口返回唯一 task_id
- 调用异步任务查询 API，传入 task_id，读取任务状态
- 状态为 running：记录进度，隔一段时间再查询，不频繁轮询
- 状态为 completed：调用接口获取 ES|QL 查询结果
- 状态为 failed：读取返回的错误信息，排查 SQL 语法、权限、资源问题
- 不需要的长耗时任务，调用取消接口终止任务释放资源
- 适合使用该 API 的场景
- 大数据量、长时间执行的 ES|QL 聚合查询
- 前端页面、业务系统需要展示查询进度的场景
- 批量 ES|QL 任务管理，需要统一查看全部任务
- 防止任务长时间占用资源，支持主动取消任务
- 开发注意要点
- 任务存在保留时效，超时后任务记录和结果会被清理
- 权限控制：用户只能查看自己提交的 ES|QL 异步任务
- 不要短间隔高频调用任务查询 API，依然会给集群带来压力
- 任务失败时，错误信息会在任务详情接口返回，方便定位 ES|QL 语句问题
【相关 FAQ】
问题 1：ES|QL 有了列出和查询异步任务的 API，是不是就完全不需要轮询了？
回答 1：ES|QL 有了列出和查询异步任务的 API，并不是完全不用轮询，而是不再无差别盲等，可以根据任务状态做低频、可控的查询，减少无效请求。
问题 2：ES|QL 查询异步任务 API，除了查看任务状态，还能做什么？
回答 2：ES|QL 有了列出和查询异步任务的 API，除了查看任务状态，还可以列出全部异步任务、取消任务、读取失败原因、拿到最终 ES|QL 查询结果。
问题 3：ES|QL 的异步任务查询 API，普通同步 ES|QL 查询能不能用？
回答 3：ES|QL 有了列出和查询异步任务的 API，这套接口只针对异步提交的 ES|QL 查询任务，普通同步查询不会生成任务记录，无法使用该 API 查询。
【参考资料】
[2026-11-12]（Elasticsearch ES|QL 异步任务查询 API 介绍）Elastic 技术社区
[2026-11-12]（ES|QL 长耗时查询异步化最佳实践）数据库技术资讯
【免责声明】
本文为 ES|QL 异步任务查询 API 相关技术科普，接口参数、权限、任务保留时长随 Elasticsearch 版本变化；生产环境使用前请参考官方文档、在测试环境验证，本文不构成线上业务落地标准。
本文来自作者[硅矢脉冲]投稿，不代表乌兰科技网立场，如若转载，请注明出处：https://www.wlcbnews.com/rgzn/202611/1821.html
评论列表（4条）
我是乌兰科技网的签约作者“硅矢脉冲”！
希望本篇文章《ES|QL 新增异步任务列表查询 API，不再需要轮询盲等任务结果》能对你有所帮助！
本站[乌兰科技网]内容主要涵盖：互联网行业的追踪与探索
本文概览：ES|QL 现在支持通过专门 API 列出、查询异步任务，开发者不用再写循环轮询的方式盲目等待查询执行完成，能直接主动获取任务状态、进度、结果信息，简化长耗时查询的开发逻辑。ES|QL 部分查询，尤其是超大索引、多表关联、复杂聚合的查询，执行耗时很长，如果没有异步任务查询能力，业务代码只能定时反复请求接口，不断判断任务有没有跑完，很容易出现无效请求、超时不好控制、资源浪费的问题。新增的这套异步任务 API，包含任务列表查看、单任务详情查询、任务状态获取能力，提交异步查询之后，拿到任务 ID，随时按需查询，还可以筛选自己名下的任务，清理失效任务，把等待逻辑从盲轮询改成按需查询，代码更稳定，也降低 ES 集群的查询压力。