# SQL 执行记录

SQL 执行记录用于查看当前工作区中的 SQL 执行记录，并打开单条记录查看 SQL 文本、查询结果和执行计划。

## 打开 SQL 执行记录

1. 进入 AI Studio 工作区。
2. 在左侧导航中打开 **监测 > SQL 执行记录**。


## 筛选查询记录

1. 设置时间范围，缩小查询记录范围。
2. 按需打开筛选条件，选择或输入以下条件：
   - SQL 类型；
   - 查询状态；
   - 数据库；
   - 用户；
   - SQL 文本；
   - 查询 ID、会话 ID 或事务 ID；
   - 耗时；
   - CU；
   - 是否包含非用户 SQL 执行记录。
3. 点击 **查询**。
4. 需要重新获取记录时，点击 **刷新**；需要清除条件时，点击 **重置**。
5. 需要保存当前筛选结果时，点击 **下载 CSV**。

筛选条件提交后，列表按当前查询结果显示记录。

## 查看查询详情

1. 在列表中找到目标查询。
2. 点击查询记录。
3. 在详情页查看以下区域：

| 区域 | 用途 |
| --- | --- |
| 查询信息 | 查看状态、时间、数据库、用户、查询 ID、会话或事务信息，以及页面返回的执行指标 |
| SQL 文本 | 查看并复制完整 SQL |
| 查询结果 | 查询成功且有可用结果时，查看结果预览 |
| 查询计划 | 查看执行算子、数据流和统计信息，定位耗时或资源开销较高的算子 |

详情页会请求最多 1000 行结果用于预览，实际返回数量取决于查询结果和接口返回。查询结果、执行计划和可见指标取决于本次记录。

## 按问题定位

- 查询失败：先查看详情中的状态和错误信息。
- 查询耗时较长：查看总体耗时，再打开 **查询计划** 定位执行算子。
- 结果与预期不符：核对 SQL 文本、数据库和执行时间，再查看结果预览。
- 需要关联一次完整工作流执行：返回[作业](jobs.md)查看工作流算子状态。
- 需要确认接口提交或权限错误：查看[操作日志](logs.md)。

## 内容边界

SQL 执行记录只负责查询 SQL 执行记录和单条查询分析，不是 SQL 编辑器、工作流作业列表或跨用户审计台。页面提供“我的记录”和“工作区记录”两个范围；切换范围后，如果请求被拒绝，页面会显示无权限提示。
