PHPKonf Istanbul PHP Conference 2019 - Call for Papers

oci_set_action

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

oci_set_actionSets the action name

Descrição

bool oci_set_action ( resource $connection , string $action_name )

Sets the action name for Oracle tracing.

The action name is registered with the database when the next 'round-trip' from PHP to the database occurs, typically when an SQL statement is executed.

The action name can subsequently be queried from database administration views such as V$SESSION. It can be used for tracing and monitoring such as with V$SQLAREA and DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE.

The value may be retained across persistent connections.

Parâmetros

connection

Um indentificador de conexção Oracle, retornado por oci_connect(), oci_pconnect(), ou oci_new_connect().

action_name

User chosen string up to 32 bytes long.

Valor Retornado

Retorna TRUE em caso de sucesso ou FALSE em caso de falha.

Exemplos

Exemplo #1 Setting the action

<?php

$c 
oci_connect('hr''welcome''localhost/XE');

// Record the action
oci_set_action($c'Friend Lookup');

// 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);

?>
// While the script is running, the administrator can see the actions
// being performed:

sqlplus system/welcome
SQL> select action from v$session;

Notas

Nota: Versão Oracle mínima

Esta função somente está disponível no PHP linkado com Oracle a partir da versão 10g em diante.

Dica

Performance

Com versões anteriores do OCI8 ou do Oracle Database, as informações do cliente podem ser configurados utilizando o pacote Oracle DBMS_APPLICATION_INFO. Isto é menos eficiente que utilizar oci_set_client_info().

Cuidado

Roundtrip Gotcha

Algumas funções OCI8 causam roundtrips. Roundtrips para o banco podem não ocorrer quando cache de resultados está ativado.

Veja Também

add a note add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top