oci_set_db_operation
PHP function
Edit on GitHub ✎
(PHP 7 >= 7.2.14, PHP 8, PHP 7 >= 7.3.1, PHP 8, PECL OCI8 >= 2.2.0)
Sets the database operation
Description
oci_set_db_operation(resource $connection, string $action): bool
Sets the DBOP for Oracle tracing.
The database operation name is registered with the database when the next 'round-trip' from PHP to the database occurs, typically when a SQL statement is executed.
The database operation can subsequently be queried from database administration views such as V$SQL_MONITOR.
The oci_set_db_operation() function is available when OCI8 uses Oracle 12 (or later) Client libraries and Oracle Database 12 (or later).
Parameters
connectionConnection
actionUser chosen string.
Return Values
Success
Examples
Setting the DBOP
php
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Record the operation
oci_set_db_operation($c, 'main query');
// Code that causes a round-trip, for example a query:
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);
sleep(30);
?>output
// While the script is running, the administrator can see the database operations
// being performed:
sqlplus system/welcome
SQL> select dbop_name from v$sql_monitor;