sqlsrv_rollback

  • [アーティクル]

PHP ドライバーのダウンロード

指定した接続で現在のトランザクションをロールバックし、接続を自動コミット モードに戻します。 現在のトランザクションには、 sqlsrv_begin_transaction の呼び出しの後、 sqlsrv_rollback または sqlsrv_commitの呼び出しの前に指定した接続で実行されたすべてのステートメントが含まれています。

Note

Microsoft SQL Server 用 Drivers for PHP は、既定で自動コミット モードになっています。 これは、すべてのクエリは、 sqlsrv_begin_transactionを使用してトランザクションを開始します。

Note

sqlsrv_begin_transaction を使用して開始されたアクティブなトランザクションに含まれていない接続で If sqlsrv_rollback が呼び出されると、その呼び出しは false を返し、Not in Transaction エラーがエラー コレクションに追加されます。

構文

  
sqlsrv_rollback( resource $conn)

パラメーター

$conn: トランザクションがアクティブな接続です。

戻り値

ブール値: トランザクションが正常にロールバックされた場合は true です。 それ以外の場合は、 falseです。

例

次の例では、トランザクションの一部として 2 つのクエリを実行します。 両方のクエリが成功すると、トランザクションはコミットされます。 いずれか (または両方) のクエリが失敗した場合、トランザクションはロールバックされます。

この例の最初のクエリは、新しい販売注文を AdventureWorks データベースの Sales.SalesOrderDetail テーブルに挿入します。 これは、製品 ID 709 の製品 5 つに対する注文です。 2 番目のクエリは、製品 ID 709 の在庫量を 5 つ分減らします。 これらのクエリはどちらも、データベースに注文および製品の可用性の状態を正確に反映する目的で成功する必要があるため、トランザクションに含まれています。

この例では、ローカル コンピューターに SQL Server および AdventureWorks データベースがインストールされていることを前提にしています。 コマンド ラインからこの例を実行すると、すべての出力はコンソールに書き込まれます。

<?php  
/* Connect to the local server using Windows Authentication and  
specify the AdventureWorks database as the database in use. */  
$serverName = "(local)";  
$connectionInfo = array( "Database"=>"AdventureWorks");  
$conn = sqlsrv_connect( $serverName, $connectionInfo);  
if( $conn === false )  
{  
     echo "Could not connect.\n";  
     die( print_r( sqlsrv_errors(), true ));  
}  
  
/* Initiate transaction. */  
/* Exit script if transaction cannot be initiated. */  
if ( sqlsrv_begin_transaction( $conn) === false )  
{  
     echo "Could not begin transaction.\n";  
     die( print_r( sqlsrv_errors(), true ));  
}  
  
/* Initialize parameter values. */  
$orderId = 43659; $qty = 5; $productId = 709;  
$offerId = 1; $price = 5.70;  
  
/* Set up and execute the first query. */  
$tsql1 = "INSERT INTO Sales.SalesOrderDetail   
                     (SalesOrderID,   
                      OrderQty,   
                      ProductID,   
                      SpecialOfferID,   
                      UnitPrice)  
          VALUES (?, ?, ?, ?, ?)";  
$params1 = array( $orderId, $qty, $productId, $offerId, $price);  
$stmt1 = sqlsrv_query( $conn, $tsql1, $params1 );  
  
/* Set up and executee the second query. */  
$tsql2 = "UPDATE Production.ProductInventory   
          SET Quantity = (Quantity - ?)   
          WHERE ProductID = ?";  
$params2 = array($qty, $productId);  
$stmt2 = sqlsrv_query( $conn, $tsql2, $params2 );  
  
/* If both queries were successful, commit the transaction. */  
/* Otherwise, rollback the transaction. */  
if( $stmt1 && $stmt2 )  
{  
     sqlsrv_commit( $conn );  
     echo "Transaction was committed.\n";  
}  
else  
{  
     sqlsrv_rollback( $conn );  
     echo "Transaction was rolled back.\n";  
}  
  
/* Free statement and connection resources. */  
sqlsrv_free_stmt( $stmt1);  
sqlsrv_free_stmt( $stmt2);  
sqlsrv_close( $conn);  
?>

トランザクションの動作を重視するため、いくつかの推奨されるエラー処理は前の例には含まれていません。 実稼働アプリケーションでは、 sqlsrv 関数のすべての呼び出しは、エラーを確認し、それに応じて処理することをお勧めします。

Note

トランザクションの実行に、埋め込みの Transact SQL を使用しないでください。 たとえば、トランザクションを開始するために、"BEGIN TRANSACTION" を Transact-SQL クエリとして使用してステートメントを実行しないでください。 埋め込みの Transact-SQL を使用してトランザクションを実行した場合、予測されるトランザクションの動作は保証できません。

参照

SQLSRV ドライバー API リファレンス

方法:トランザクションを実行する

Microsoft SQL Server 用 Drivers for PHP の概要