| 元素 | 用途 | 关键注意事项 |
|---|---|---|
| file_name | 解释输出文件的名称 | 如果不包含绝对路径，那么将在该样本输出文件的位置创建样本输出文件。如果存在该文件，解释输出会附加在其中。如果文件正用于 SET EXPLAIN 语句中，那么该文件不能使用直到动态解释关闭 |
| session_id | 指示特定会话 | 无 |
| -Y | 动态更改 SET EXPLAIN 语句的值 | 无 |
您可以使用 SET EXPLAIN 语句显示优化程序的查询计划、对返回行数的估计以及查询的相对开销。当使用 onmode -Y 命令开启 SET EXPLAIN 时，输出显示在解释的输出文件中。
| 调用 | 解释 |
|---|---|
| onmode -Y session_id 2 | 开启对 session_id 的 SET EXPLAIN |
| onmode -Y session_id 1 | 开启对 session_id 的 SET EXPLAIN 并且在解释输出文件中显示查询统计一节 |
| onmode -Y session_id 1 /tmp/myexplain.out | 开启对 session_id 的 SET EXPLAIN 并将解释写入到 /tmp/myexplain.out 输出文件 |
| onmode -Y session_id 0 | 关闭对 session_id 的 SET EXPLAIN |
该命令有等同的 SQL 管理 API 函数。