# 查询 SQL 执行记录

按条件查询 SQL 执行记录，用于定位需要进一步查看的执行。需要主动提交、取消或取得某次执行结果时，请参阅[执行 SQL 和管理 SQL 元数据](../data-processing/sql-execution-metadata.md)。

## 前提条件

准备可访问目标工作区的凭据。有关服务地址、认证和通用请求格式，请参阅[调用前准备](../../api-call-basics.md)。

如果需要缩小查询范围，请准备已知的执行、工作区或时间等筛选条件，并以动作页支持的条件为准。

## 调用顺序

1. 根据要排查的范围查看 SQL 历史概览或 SQL 执行记录，并在返回记录中定位目标执行。
2. 需要了解该执行的语句内容、状态、耗时、错误或执行计划时，先记下语句 ID 和执行时间，再查看执行详情或执行计划。
3. 需要了解该执行的状态或结果时，转到 SQL 执行场景，使用相应的状态或结果动作继续确认。

## API 操作

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查看 SQL 历史概览 | [查看 SQL 历史概览](../../../../reference/api/ai-studio/monitoring/get-sql-history-overview.md) | 需要按时间范围和 SQL 来源汇总执行记录数量时使用。 |
| 查询 SQL 执行记录 | [查看 SQL 执行记录](../../../../reference/api/ai-studio/monitoring/list-sql-execution-records.md) | 需要浏览或筛选已有 SQL 执行记录时使用。 |
| 查看 SQL 执行详情 | [查看 SQL 执行详情](../../../../reference/api/ai-studio/monitoring/get-sql-execution-details.md) | 已从记录中取得语句 ID 和执行时间，需要查看完整执行信息时使用。 |
| 查看 SQL 执行计划 | [查看 SQL 执行计划](../../../../reference/api/ai-studio/monitoring/get-sql-execution-profile.md) | 已从记录中取得语句 ID 和执行时间，需要分析执行步骤和资源使用情况时使用。 |

## 结果确认

检查概览或返回记录是否覆盖目标范围并包含目标执行。获得目标执行后，使用[查看 SQL 执行详情](../../../../reference/api/ai-studio/monitoring/get-sql-execution-details.md)、[查看 SQL 执行计划](../../../../reference/api/ai-studio/monitoring/get-sql-execution-profile.md)、[查看执行状态](../../../../reference/api/ai-studio/data-processing/sql-execution/get-execution-status.md)和[查看执行结果](../../../../reference/api/ai-studio/data-processing/sql-execution/get-execution-result.md)继续确认执行情况和结果。

## 下一步

- [执行 SQL 和管理 SQL 元数据](../data-processing/sql-execution-metadata.md)
- [查询操作日志](operation-logs.md)