(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL OCI8 >= 1.4.0)
oci_set_action — Define el nombre de la acción
Define el nombre de la acción para un seguimiento de Oracle.
El nombre de la acción se registra en la base de datos durante el próximo intercambio 'round-trip' desde PHP hacia la base de datos; típicamente, cuando se ejecuta una consulta SQL.
El nombre de la acción puede ser consultado posteriormente desde la vista de administración
de la base de datos V$SESSION
.
Puede ser utilizado para rastrear y monitorear otras vistas como
V$SQLAREA
y DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE
.
El valor puede ser conservado a través de las conexiones persistentes.
connection
Un identificador de conexión de Oracle, devuelto por oci_connect(), oci_pconnect(), o oci_new_connect().
action
String seleccionado por el usuario de hasta 32 caracteres de longitud.
Ejemplo #1 Definición de una acción
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Registra la acción
oci_set_action($c, 'Friend Lookup');
// Código que genera un intercambio (round-trip), por ejemplo, una consulta:
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);
sleep(30);
?>
// Durante la ejecución del script, el administrador puede ver las acciones // en curso de ejecución: sqlplus system/welcome SQL> select action from v$session;
Nota: Requisito de versión de Oracle
Esta función esta disponible cuando PHP está vinculado con bibliotecas de Oracle Database de la versión 10g en adelante.
Con versiones antiguas de
OCI8 o de Oracle Database, se puede establecer la información del cliente usando el paquete
DBMS_APPLICATION_INFO
de Oracle. Esto es menos eficiente que
utilizar oci_set_client_info().
Algunas, pero no todas, las funciones de OCI8 causan viajes de ida y vuelta. Estos podrían no ocurrir con las consultas cuando está habilitado el almacenamiento en caché de resultados.