oci_set_action

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

oci_set_actionSets the action name

˵��

oci_set_action ( resource $connection , string $action_name ) : bool

Sets the action name for Oracle tracing.

The action name is registered with the database when the next 'round-trip' from PHP to the database occurs, typically when an SQL statement is executed.

The action name can subsequently be queried from database administration views such as V$SESSION. It can be used for tracing and monitoring such as with V$SQLAREA and DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE.

The value may be retained across persistent connections.

����

connection

Oracle ���ӱ�ʶ���� oci_connect()��oci_pconnect()���� oci_new_connect() ���ء�

action_name

User chosen string up to 32 bytes long.

����ֵ

�ɹ�ʱ���� TRUE�� ������ʧ��ʱ���� FALSE��

����

Example #1 Setting the action

<?php

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

// Record the action
oci_set_action($c'Friend Lookup');

// Code that causes a round-trip, for example a query:
$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;

ע��

Note: Oracle �汾����

�� PHP ���� Oracle ���ݿ� 10g �����°汾�� ��չ������ʱ���˺������á�

Tip

����

ʹ�þɰ�� OCI8 �� ORACLE ���ݿ� ����ʹ�� Oracle DBMS_APPLICATION_INFO �������ÿͻ�����Ϣ�����ʹ�� oci_set_client_info() �ϵ�Ч��

Caution

Roundtrip Gotcha

һЩ OCI8 �����ᵼ�� Roundtrips. �����ݿ���˵�����ý������ʱ����ѯ���ܲ�����Roundtrips��

�μ�