sesam_settransaction

(PHP 3 CVS only)

sesam_settransaction -- Parameter der SESAM-Transaction setzen

Beschreibung

bool sesam_settransaction ( int isolation_level, int read_only)

Ergibt TRUE für gültige Werte und wenn settransaction() erfolgreich war, ansonsten FALSE.

sesam_settransaction() überschreibt die Standardwerte für "isolation level" Parameter und die in der SESAM-Konfigurationsdatei gesetzten "read-only" Transaktionsparameter, um nachfolgende Abfragen zu optimieren und die Konsistenz der Datenbank sicherzustellen. Die geänderten (überschriebenen) Werte wirken nur auf die nächste Transaktion.

sesam_settransaction() kann nur vor dem Start aufgerufen werden, also nicht, wenn eine Transaktion bereits gestartet wurde.

Um die Anwendung in PHP-Scripts zu vereinfachen, wurden folgende Konstanten in PHP vordefiniert (zur Erläuterung der Semantik siehe SESAM-Benutzerhandbuch):

Tabelle 1. Gültige Werte für "Isolation_Level" Parameter

ValueConstantMeaning
1SESAM_TXISOL_READ_UNCOMMITTEDRead Uncommitted
2SESAM_TXISOL_READ_COMMITTEDRead Committed
3SESAM_TXISOL_REPEATABLE_READRepeatable Read
4SESAM_TXISOL_SERIALIZABLESerializable

Tabelle 2. Gültige Werte für "Read_Only" Parameter

ValueConstantMeaning
0SESAM_TXREAD_READWRITERead/Write
1SESAM_TXREAD_READONLYRead-Only

Die von sesam_settransaction() gesetzten Werte überschreiben die in der SESAM-Konfigurationsdatei gesetzten Standardwerte.

Beispiel 1. Setzen von SESAM-Transaktionsparametern

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