(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL OCI8 >= 1.4.0)
oci_set_module_name — Define el nombre del módulo
Define el nombre del módulo para el trazado de Oracle.
El nombre del módulo se registra en la base de datos durante el próximo viaje de ida y vuelta 'round-trip' desde PHP hacia la base de datos; típicamente, cuando se ejecuta una consulta SQL.
El nombre podrá ser consultado posteriormente desde la vista de administración
de la base de datos como V$SESSION
. También podrá
ser utilizado para el trazado y la supervisión, como con
V$SQLAREA
y DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE
.
El valor será retenido mediante el mecanismo de conexiones persistentes.
connection
Un identificador de conexión Oracle, devuelto por la función oci_connect(), oci_pconnect() o la función oci_new_connect().
name
String seleccionado por el usuario con una longitud máxima de 48 caracteres.
Ejemplo #1 Definición del nombre del módulo
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Registro del módulo
oci_set_module_name($c, 'Home Page');
// Código que genera un viaje de ida y vuelta (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 los // módulos en uso: sqlplus system/welcome SQL> select module from v$session;
Nota: Requerido por la versión Oracle
Esta función está disponible si PHP está vinculado a partir de la versión 10g de la biblioteca de la base de datos Oracle.
Con versiones antiguas de OCI8 o bases de datos Oracle antiguas, la información del cliente
puede ser definida usando el paquete Oracle DBMS_APPLICATION_INFO
.
Esto es menos eficiente que usar la función
oci_set_client_info().
Algunas funciones OCI8 requieren ida y vuelta con la base de datos. Estas ida y vuelta pueden ser evitadas al usar consultas cuyo resultado es almacenado en caché.