oci_set_action
En esta página
oci_set_action
Define el nombre de la acción
Descripción#
oci_set_action(resource $connection, string $action): bool
```php
Define el nombre de la acción para un seguimiento de Oracle.
El nombre de la acción se registra en la base de datos durante el próximo intercambio 'round-trip' desde PHP hacia la base de datos; típicamente, cuando se ejecuta una consulta SQL.
El nombre de la acción puede ser consultado posteriormente desde la vista de administración de la base de datos `V$SESSION`. Puede ser utilizado para rastrear y monitorear otras vistas como `V$SQLAREA` y `DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE`.
El valor puede ser conservado a través de las 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`.
`action`
String seleccionado por el usuario de hasta 32 caracteres de longitud.
## Valores devueltos
Esta función retorna `true` en caso de éxito o `false` si ocurre un error.
## Ejemplos
Definición de una acción
```php
// Durante la ejecución del script, el administrador puede ver las acciones
// en curso de ejecución:
sqlplus system/welcome
SQL> select action 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_module_name, oci_set_client_info, oci_set_client_identifier, oci_set_db_operation