(PHP 5 >= 5.3.2, PHP 7, PECL OCI8 >= 1.4.0)
oci_set_module_name — Establece el nombre de un módulo
$connection
, string $module_name
) : boolEstablece el nombre de un módulo para el rastreo de Oracle.
El nombre del módulo se registra con la base de datos cuando ocurra el siguiente "viaje de ida y vuelta" desde PHP a la base de datos, normalemnte cuando una sentencia SQL es ejecutada.
El nombre del módulo puede ser consultado posteriormente desde una vista de administración de la base de datos como V$SESSION. Se puede usar para rastrear y monitorizar como con V$SQLAREA y DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE.
El valor podría manterse entre conexiones persistentes.
connection
Un identificador de conexión de Oracle, devuelto por oci_connect(), oci_pconnect(), o oci_new_connect().
module_name
El string elegido por el usuario, hasta 48 bytes de longitud.
Devuelve TRUE
en caso de éxito o FALSE
en caso de error.
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.
Ejemplo #1 Establecer el nombre del módulo
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Grabar el módulo
oci_set_module_name($c, 'Home Page');
// Código que causa un viaje de ida y vuelta, por ejemplo una consulta:
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);
sleep(30);
?>
// Mientras el script se esté ejecutando, el administrador puede ver el // módulo en uso: sqlplus system/welcome SQL> select module from v$session;