2024年PHP开发者大会日本站

oci_set_action

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

oci_set_action设置操作名称

描述

oci_set_action(资源 $connection, 字符串 $action): 布尔值

设置Oracle跟踪的操作名称。

当下次从PHP到数据库的“往返”发生时,操作名称将在数据库中注册,通常是在执行SQL语句时。

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

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

参数

connection

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

action

用户选择的长度最多为32字节的字符串。

返回值

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

示例

示例 #1 设置操作

<?php

$c
= oci_connect('hr', 'welcome', 'localhost/XE');

// 记录操作
oci_set_action($c, 'Friend Lookup');

// 导致往返的代码,例如查询:
$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 actions
// being performed:

sqlplus system/welcome
SQL> select action from v$session;

注释

注意: Oracle版本要求

当PHP链接到10g及更高版本的Oracle数据库库时,此函数可用。

提示

性能

对于较旧版本的OCI8或Oracle数据库,可以使用Oracle DBMS_APPLICATION_INFO包设置客户端信息。这不如使用oci_set_client_info()高效。

警告

往返问题

某些(并非所有)OCI8函数会导致往返。当启用结果缓存时,查询可能不会发生数据库往返。

参见

添加注释

用户贡献的注释

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