oci_set_module_name
En esta página
oci_set_module_name
Define el nombre del módulo
Descripción#
oci_set_module_name(resource $connection, string $name): bool
```php
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 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.
## Valores devueltos
Esta función retorna `true` en caso de éxito o `false` si ocurre un error.
## Ejemplos
Definición del nombre del módulo
```php
// 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#
[!NOTE] 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.
[!TIP] 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ónoci_set_client_info.[!CAUTION] 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é.
Véase también#
oci_set_action, oci_set_client_info, oci_set_client_identifier, oci_set_db_operation