oci_set_module_name

(PHP 5 >= 5.3.2,PHP 7,PHP 8,PECL OCI8 >= 1.4.0)

oci_set_module_name设置模块名称

说明

oci_set_module_name(resource $connection, string $name): bool

设置 Oracle 跟踪的模块名称。

模块名称在下次从 PHP 到数据库的“往返”发生时(通常是在执行 SQL 语句时)注册到数据库。

该名称随后可以从数据库管理视图中查询,例如 V$SESSION。它可以用于跟踪和监控,例如使用 V$SQLAREADBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE

该值可能在持久连接中保留。

参数

connection

oci_connect()oci_pconnect()oci_new_connect() 返回的 Oracle 连接标识符。

name

用户选择的 string,长度不超过 48 个字节。

返回值

成功时返回 true,失败时返回 false

示例

示例 #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 函数会导致往返。当启用结果缓存时,查询可能不会发生到数据库的往返。

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top