oci_set_module_name
(PHP 5 >= 5.3.2, PHP 7, PECL OCI8 >= 1.4.0)
oci_set_module_name — Définit le nom du module
Description
$connection
, string $module_name
) : boolDéfinit le nom du module pour le tracage Oracle.
Le nom du module est enregistré avec la base de données lors du prochain aller-retour 'round-trip' depuis PHP vers la base de données survient ; typiquement, lorsqu'une requête SQL est exécutée.
Le nom pourra être ensuite interrogé depuis la vue d'administration de la base de données comme V$SESSION. Il pourra être également utilisé pour du traçage et de la surveillance, comme avec V$SQLAREA et DBMS_MONITOR.SERV_MOD_ACT_STAT_ENABLE.
La valeur sera retenue via le mécanisme des connexions persistantes.
Liste de paramètres
-
connection
-
Un identifiant de connexion Oracle, retourné par la fonction oci_connect(), oci_pconnect() ou la fonction oci_new_connect().
-
module_name
-
Chaîne choisie par l'utilisateur jusqu'à 48 octets de long.
Notes
Note: Requis par la version Oracle
Cette fonction est disponible si PHP est lié à partir de la version 10g de la bibliothèque de la base de données Oracle .
Performance
Avec les anciennes version OCI8 ou les anciennes bases de données Oracle, l'information quant au client peut être défini en utilisant le paquet Oracle DBMS_APPLICATION_INFO. Ceci est moins efficace que d'utiliser la fonction oci_set_client_info().
Exemples
Exemple #1 Définition du nom du module
<?php
$c = oci_connect('hr', 'welcome', 'localhost/XE');
// Enregistrement du module
oci_set_module_name($c, 'Home Page');
// Code générant un aller-retour (round-trip), par exemple, une requête :
$s = oci_parse($c, 'select * from dual');
oci_execute($s);
oci_fetch_all($s, $res);
sleep(30);
?>
// Pendant l'exécution du script, l'administrateur peut voir les // modules enn utilisation : sqlplus system/welcome SQL> select module from v$session;
Voir aussi
- oci_set_action() - Définit le nom de l'action
- oci_set_client_info() - Définit l'information concernant le client
- oci_set_client_identifier() - Définit l'identifiant du client
- oci_set_db_operation() - Sets the database operation
Version en cache
23/12/2024 04:51:20 Cette version de la page est en cache (à la date du 23/12/2024 04:51:20) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.oci-set-module-name.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.