使用 AVOID_EXECUTE 选项

AVOID_EXECUTE 关键字防止 DML 语句执行。相反，数据库服务器将查询计划打印到输出文件。

SET EXPLAIN ON AVOID_EXECUTE 语句为会话激活 Avoid Execute 选项，或直到下一不带 AVOID_EXECUTE 的 SET EXPLAIN OFF（或 ON）为止。如果您为包含远程表的查询激活 AVOID_EXECUTE，则该查询既不在本地也不在远程站点执行。

下列示例在指定的文件中存储输出。

SET EXPLAIN ON AVOID_EXECUTE;
        SET EXPLAIN FILE TO '/tmp/explain.out';

当设置 AVOID_EXECUTE 时，数据库服务器发出警告消息。如果您正在使用 DB-Access，则它为任何选择、删除、更新或插入查询操作显示文本消息。

Warning! avoid_execute has been set

对于 ESQL，sqlwarn.sqlwarn7 字符设置为 'W'。

使用 SET EXPLAIN ON 或 SET EXPLAIN OFF 语句来关闭 AVOID_EXECUTE 选项。SET EXPLAIN ON 语句关闭 AVOID_EXECUTE 选项，但继续生成查询计划并将结果写到输出文件。

如果您在 SPL 例程中发出 SET EXPLAIN ON AVOID_EXECUTE 语句，则该 SPL 例程和任何 DDL 语句仍然执行，但在该 SPL 例程内部的 DML 语句不执行。数据库服务器将该 SPL 例程的查询计划打印到输出文件。要关闭此选项，您必须在该 SPL 例程的外部执行 SET EXPLAIN ON 或 SET EXPLAIN OFF 语句。如果您在执行 SPL 例程之前执行 SET EXPLAIN ON AVOID_EXECUTE 语句，则在该 SPL 例程内部的 DML 语句不执行，且数据库服务器不将该 SPL 例程的查询计划打印到输出文件。

当 AVOID_EXECUTE 生效时，仍然对查询中的恒定函数求值，因为数据库服务器在优化之前计算这些函数。

例如，即使不执行下列 SELECT 语句，也对 func( ) 函数求值：

SELECT * FROM orders WHERE func(10) > 5;

要了解 AVOID_EXECUTE 选项的其他性能影响，请参阅 GBase 8s 性能指南。

如果您在 GBase 8s ESQL/C 程序中打开游标之前执行 SET EXPLAIN ON AVOID_EXECUTE 语句，则每一 FETCH 操作都返回找不到行的消息。然而，如果您在 GBase 8s ESQL/C 程序打开游标之后执行 SET EXPLAIN ON AVOID_EXECUTE，则此语句对游标不起作用，其继续返回行。