sesam_settransaction

(PHP 3 CVS only)

sesam_settransaction -- Modifie les paramètres de transaction SESAM

Description

bool sesam_settransaction ( int isolation_level, int read_only )

sesam_settransaction() retourne TRUE si les valeurs sont valides et que la modification a été réussie. FALSE sinon.

sesam_settransaction() remplace les valeurs par défaut du niveau d'isolation ("isolation level") et de lecture seule ("read-only") fixée par le fichier de configuration SESAM), afin d'optimiser les requêtes ultérieures et garantir la cohérence de la base. Ces valeurs ne sont utilisées que pour la prochaine transaction.

sesam_settransaction() ne peut être appelée qu'avant le début de la transaction. Elle est inefficace si la transaction a déjà commencé.

Pour simplifier l'utilisation de cette fonction dans les scripts PHP, les constantes suivantes ont été définies en PHP (reportez-vous au manuel SESAM pour avoir des détails sur leur signification) :

Tableau 1. Valeurs valides pour le paramètre isolation_level

ValeurConstanteSignification
1SESAM_TXISOL_READ_UNCOMMITTEDLecture sans validation
2SESAM_TXISOL_READ_COMMITTEDLecutre avec validation
3SESAM_TXISOL_REPEATABLE_READLecture récurrente
4SESAM_TXISOL_SERIALIZABLESérialisable

Tableau 2. Valeurs valides pour le paramètre read_only

ValeurConstanteSignification
0SESAM_TXREAD_READWRITELecture/écriture
1SESAM_TXREAD_READONLYLecture seule

Les valeurs modifiées par sesam_settransaction() remplaceront les valeurs par défaut spécifiée dans le fichier de configuration SESAM.

Exemple 1. Modifier les paramètres de configuration SESAM

<?php
sesam_settransaction
(SESAM_TXISOL_REPEATABLE_READ, SESAM_TXREAD_READONLY);
?>