onmode 和 e 参数：更改 SQL 语句高速缓存的用法（SQL 管理 API）

随同 admin() 或 task() 函数，使用 onmode 和 e 参数来临时地更改 SQL 语句高速缓存的模式。

语法

用法

如果禁用了 SQL 语句高速缓存，则使用 enable 参数来启用它。仅在执行下列活动之后，单个用户会话可使用该语句高速缓存：

设置环境变量 STMT_CACHE 为 1。
执行 SQL 语句 SET STATEMENT CACHE ON。

使用 flush 参数来从 SQL 语句高速缓存清空不使用的语句，SQL 语句高速缓存保持启用。清空高速缓存之后，onstat -g ssc ref_cnt 域显示为 0。

使用 off 参数来关闭 SQL 语句高速缓存，以便不高速缓存语句。

使用 on 参数来高速缓存所有语句，除了那些用户通过下列活动之一关闭的之外：

使用这个命令来指定 OFF 模式。
设置环境变量 STMT_CACHE 为 0。
执行 SQL 语句 SET STATEMENT CACHE OFF。

这个函数不可更改 ONCONFIG 文件中 STMT_CACHE 配置参数的设置，但最后的参数覆盖那个设置（或如果未设置 STMT_CACHE，则为缺省值）。您以这个命令进行的任何语句高速缓存行为的变更都仅影响当前数据库服务器会话。当您重启数据库服务器时，数据库服务器使用 ONCONFIG 文件中 STMT_CACHE 参数的设置。如果在 ONCONFIG 文件中未定义 STMT_CACHE 配置参数，则服务器不使用语句高速缓存。

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

示例

下列示例启用 SQL 语句高速缓存：

EXECUTE FUNCTION task("onmode","e","enable");