oci_set_module_name
(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL OCI8 >= 1.4.0)
oci_set_module_name — Establece el nombre de un módulo
Descripción
Establece 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.
Parámetros
-
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.
Valores devueltos
Devuelve true en caso de éxito o false en caso de error.
Notas
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.
Rendimiento
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().
Problema con los viajes de ida y vuelta
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.
Ejemplos
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;
Ver también
- oci_set_action() - Establece el nombre de una acción
- oci_set_client_info() - Establece la información del cliente
- oci_set_client_identifier() - Establece el identificador del cliente
add a note
