(PHP 5 >= 5.3.2,PHP 7,PHP 8,PECL OCI8 >= 1.4.0)
oci_set_module_name — 设置模块名称
设置 Oracle 跟踪的模块名称。
模块名称在下次从 PHP 到数据库的“往返”发生时(通常是在执行 SQL 语句时)注册到数据库。
该名称随后可以从数据库管理视图中查询,例如 V$SESSION
。它可以用于跟踪和监控,例如使用 V$SQLAREA
和 DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE
。
该值可能在持久连接中保留。
connection
由 oci_connect()、oci_pconnect() 或 oci_new_connect() 返回的 Oracle 连接标识符。
name
用户选择的 string,长度不超过 48 个字节。
示例 #1 设置模块名称
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// 记录模块
oci_set_module_name($c, 'Home Page');
// 导致往返的代码,例如查询:
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);
sleep(30);
?>
// While the script is running, the administrator can see the // modules in use: sqlplus system/welcome SQL> select module from v$session;
注意: Oracle 版本要求
当 PHP 与 Oracle 数据库库链接时,从版本 10g 开始,此函数可用。
对于较旧版本的 OCI8 或 Oracle 数据库,可以使用 Oracle DBMS_APPLICATION_INFO
包设置客户端信息。这不如使用 oci_set_client_info() 效率高。
某些(但不是全部)OCI8 函数会导致往返。当启用结果缓存时,查询可能不会发生到数据库的往返。