oci_set_client_info
(PHP 5 >= 5.3.2, PHP 7, PHP 8, PECL OCI8 >= 1.4.0)
oci_set_client_info — Establece la información del cliente
Descripción
$connection
, string $client_info
) : boolEstablece la información del cliente para el rastreo de Oracle.
La información del cliente 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.
La información del cliente puede ser consultado posteriormente desde una vista
de administración de la base de datos como V$SESSION.
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().
-
client_info -
La cadena elegida por el usuario, hasta 64 bytes de longitud.
Valores devueltos
Devuelve true en caso de éxito o false en caso de error.
Ejemplos
Ejemplo #1 Establecer la información del cliente
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Grabar la información del cliente
oci_set_client_info($c, 'My Application Version 2');
// 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 la informaicón // del cliente: sqlplus system/welcome SQL> select client_info 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.
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.
Ver también
- oci_set_module_name() - Establece el nombre de un módulo
- oci_set_action() - Establece el nombre de una acción
- oci_set_client_identifier() - Establece el identificador del cliente
add a note
