oci_set_module_name

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

oci_set_module_nameDefine el nombre del módulo

Descripción

oci_set_module_name(resource $connection, string $name): bool

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.

Parámetros

connection

Un identificador de conexión de Oracle, devuelto por oci_connect(), oci_pconnect(), o oci_new_connect().

name

String seleccionado por el usuario con una longitud máxima de 48 caracteres.

Valores devueltos

Devuelve true en caso de éxito o false en caso de error.

Ejemplos

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;

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.

Sugerencia

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().

Precaución

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.

Ver también