db2_rollback

(PECL ibm_db2 >= 1.0.0)

db2_rollback トランザクションをロールバックする

説明

db2_rollback(resource $connection): bool

指定した接続リソース上で実行中のトランザクションをロールバックし、 新しいトランザクションを開始します。PHP アプリケーションのデフォルトは AUTOCOMMIT モードなので、接続リソースに対して AUTOCOMMIT を無効にしていない限り db2_rollback() は何の意味もありません。

パラメータ

connection

db2_connect() あるいは db2_pconnect() が返した有効なデータベース接続リソース。

戻り値

成功した場合に true を、失敗した場合に false を返します。

例1 DELETE 文のロールバック

以下の例では、テーブルの行数を数えた後にデータベース接続の AUTOCOMMIT を無効にし、テーブルのすべての行を削除した上で、 行数が 0 となっていることを確認します。 それから、db2_rollback() を発行して再度行数を取得し、 DELETE 文の発行前の状態に戻っていることを確認します。 これにより、トランザクションのロールバックが正常に行われたことを示します。

<?php
$conn 
db2_connect($database$user$password);

if (
$conn) {
    
$stmt db2_exec($conn"SELECT count(*) FROM animals");
    
$res db2_fetch_array$stmt );
    echo 
$res[0] . "\n";
    
    
// AUTOCOMMIT を無効にします
    
db2_autocommit($connDB2_AUTOCOMMIT_OFF);
   
    
// ANIMALS のすべての行を削除します
    
db2_exec($conn"DELETE FROM animals");
    
    
$stmt db2_exec($conn"SELECT count(*) FROM animals");
    
$res db2_fetch_array$stmt );
    echo 
$res[0] . "\n";
    
    
// DELETE 文をロールバックします
    
db2_rollback$conn );
    
    
$stmt db2_exec$conn"SELECT count(*) FROM animals" );
    
$res db2_fetch_array$stmt );
    echo 
$res[0] . "\n";
    
db2_close($conn);
}
?>

上の例の出力は以下となります。

7
0
7

参考

  • db2_autocommit() - データベース接続の AUTOCOMMIT の状態を取得または設定する
  • db2_commit() - トランザクションをコミットする

関連キーワード:  トランザクション, rollback, 接続, AUTOCOMMIT, データベース, リソース, connection, 状態, 取得, 発行