onmode 和 Y 参数：更改会话的查询计划度量（SQL 管理 API）

随同 admin() 或 task() 函数，使用 onmode 和 Y 参数来更改对个别会话查询计划度量的输出。

语法

元素	描述	关键考虑
`file_name`	说明输出文件名。	如果未包括该文件的绝对路径，则在缺省示例输出文件位置中创建示例输出文件。如果文件已经存在，说明输出附加到该文件。如果从 SET EXPLAIN 语句已经存在一个文件，则不再使用那个文件直到关闭动态的说明。
`session_id`	标识特定的会话。	无。
-Y	动态地更改 SET EXPLAIN 语句的值。	无。

您可使用这个函数来与 SET EXPLAIN 语句竞争。

最后的参数确定是否记录查询度量，包括查询优化器的计划、对返回行数的估计以及查询的相对成本。

使用 2 参数来使得数据库服务器能发送查询计划到说明输出文件。

使用 1 参数来使得数据库服务器能发送查询计划和统计到说明输出文件。这个设置等同于特定会话的 SET EXPLAIN ON 语句。

使用 0 参数来使得查询度量不能输出到当前会话的说明输出文件。这个设置等同于 SET EXPLAIN OFF 语句。

这个函数等同于 onmode -Y 命令。

下列示例使得 ID 为 32 的用户会话不能输出查询度量：

EXECUTE FUNCTION task("onmode","Y","32","0");