現在のトランザクションへのアクセス

[アーティクル]
12/15/2008

Microsoft SQL Server で実行されている CLR (共通言語ランタイム) コードに実行が移った時点でトランザクションがアクティブな場合、System.Transactions.Transaction クラスによりそのトランザクションが公開されます。現在のトランザクションにアクセスするには、Transaction.Current プロパティを使用します。ほとんどの場合、トランザクションに明示的にアクセスする必要はありません。データベース接続の場合、Connection.Open メソッドが呼び出されると、ADO.NET が Transaction.Current を自動的にチェックし、ユーザーに意識させることなく接続をそのトランザクションに参加させます (接続文字列の Enlist キーワードを false に設定した場合は除く)。

次のような場合には、Transaction オブジェクトを直接使用できます。

自動参加が行われないリソースや、何らかの理由で初期化中に参加しなかったリソースを参加させる場合。
リソースを明示的にトランザクションに参加させる場合。
ストアドプロシージャまたは関数内から外部トランザクションを終了させる場合。この場合は、Transaction.Current.Rollback メソッドを呼び出します。以下に、外部トランザクションをキャンセルする別の方法を説明します。

外部トランザクションのキャンセル

外部トランザクションは、次の方法でマネージプロシージャまたは関数からキャンセルできます。

マネージプロシージャまたは関数は、出力パラメータを使用して値を返すことができます。呼び出し元の Transact-SQL プロシージャは、戻り値を確認して、必要に応じて ROLLBACK TRANSACTION を実行できます。
マネージプロシージャまたは関数は、カスタムの例外をスローできます。呼び出し元の Transact-SQL プロシージャは、マネージプロシージャまたは関数がスローした例外を try/catch ブロックでキャッチして、ROLLBACK TRANSACTION を実行できます。
マネージプロシージャまたは関数は、特定の条件が満たされた場合に Transaction.Rollback メソッドを呼び出して、現在のトランザクションをキャンセルできます。

マネージプロシージャまたは関数の内部から呼び出された場合、Transaction.Rollback メソッドは不明確なエラーメッセージを表示して例外をスローし、これを try/catch ブロックでラップできます。表示されるエラーメッセージは、たとえば次のようになります。

Msg 3994, Level 16, State 1, Procedure uspRollbackFromProc, Line 0
Transaction is not allowed to roll back inside a user defined routine, trigger or aggregate because the transaction is not started in that CLR level. Change application logic to enforce strict transaction nesting.

この例外は想定されるものであり、コードの実行を継続するには try/catch ブロックが必要です。try/catch ブロックがない場合、例外はすぐに呼び出し元の Transact-SQL プロシージャにスローされ、マネージコードの実行は終了します。マネージコードが実行を終了すると、別の例外が発生します。

Msg 3991, Level 16, State 1, Procedure uspRollbackFromProc, Line 1 
The context transaction which was active before entering user defined routine, trigger or aggregate " uspRollbackFromProc " has been ended inside of it, which is not allowed. Change application logic to enforce strict transaction nesting. The statement has been terminated.

この例外も想定されるもので、実行を継続するには、トリガを起動するアクションを実行する Transact-SQL ステートメントでの try/catch ブロックが必要です。この 2 つの例外がスローされますが、トランザクションはロールバックされ、変更はコミットされません。

例

次の例では、Transaction.Rollback メソッドを使用してマネージプロシージャからトランザクションをロールバックします。マネージコード内にある Transaction.Rollback メソッドの前後の try/catch ブロックに注意してください。Transact-SQL スクリプトは、アセンブリおよびマネージストアドプロシージャを作成します。マネージプロシージャが実行を終了したときにスローされる例外をキャッチするため、EXEC uspRollbackFromProc ステートメントが try/catch ブロックにラップされていることに注意してください。

using System;
using System.Data;
using System.Data.SqlClient;
using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;
using System.Transactions;

public partial class StoredProcedures
{
[Microsoft.SqlServer.Server.SqlProcedure]
public static void uspRollbackFromProc()
{
   using (SqlConnection connection = new SqlConnection(@"context connection=true"))
   {
      // Open the connection.
      connection.Open();

      bool successCondition = true;

      // Success condition is met.
      if (successCondition)
      {
         SqlContext.Pipe.Send("Success condition met in procedure."); 
         // Perform other actions here.
      }
            
      //  Success condition is not met, the transaction will be rolled back.
      else
      {
         SqlContext.Pipe.Send("Success condition not met in managed procedure. Transaction rolling back...");
         try
         {
               // Get the current transaction and roll it back.
               Transaction trans = Transaction.Current;
               trans.Rollback();
         }
         catch (SqlException ex)
         {
            // Catch the expected exception. 
            // This allows the connection to close properly.                    
         }  
      }

      // Close the connection.
      connection.Close();
   }
}
};

Visual Basic

Imports System
Imports System.Data
Imports System.Data.SqlClient
Imports System.Data.SqlTypes
Imports Microsoft.SqlServer.Server
Imports System.Transactions

Partial Public Class StoredProcedures
<Microsoft.SqlServer.Server.SqlProcedure()> _
Public Shared Sub  uspRollbackFromProc ()
   Using connection As New SqlConnection("context connection=true")

   ' Open the connection.
   connection.Open()

   Dim successCondition As Boolean
   successCondition = False

   ' Success condition is met.
   If successCondition Then

      SqlContext.Pipe.Send("Success condition met in procedure.")

      ' Success condition is not met, the transaction will be rolled back.

   Else
      SqlContext.Pipe.Send("Success condition not met in managed procedure. Transaction rolling back...")
      Try
         ' Get the current transaction and roll it back.
         Dim trans As Transaction
         trans = Transaction.Current
         trans.Rollback()

      Catch ex As SqlException
         ' Catch the exception instead of throwing it.  
         ' This allows the connection to close properly.                    
      End Try

   End If

   ' Close the connection.
   connection.Close()

End Using
End Sub
End Class

Transact-SQL

--Register assembly.
CREATE ASSEMBLY TestProcs FROM 'C:\Programming\TestProcs.dll' 
Go
CREATE PROCEDURE uspRollbackFromProc AS EXTERNAL NAME TestProcs.StoredProcedures.uspRollbackFromProc
Go

-- Execute procedure.
BEGIN TRY
BEGIN TRANSACTION 
-- Perform other actions.
Exec uspRollbackFromProc
-- Perform other actions.
PRINT N'Commiting transaction...'
COMMIT TRANSACTION
END TRY

BEGIN CATCH
SELECT ERROR_NUMBER() AS ErrorNum, ERROR_MESSAGE() AS ErrorMessage
PRINT N'Exception thrown, rolling back transaction.'
ROLLBACK TRANSACTION
PRINT N'Transaction rolled back.' 
END CATCH
Go

-- Clean up.
DROP Procedure uspRollbackFromProc;
Go
DROP ASSEMBLY TestProcs;
Go

参照

概念

CLR 統合とトランザクション

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース	履歴
2006 年 12 月 12 日	新しい内容 : 「外部トランザクションのキャンセル」セクションを追加しました。

次の方法で共有

現在のトランザクションへのアクセス

外部トランザクションのキャンセル

例

参照

概念

ヘルプおよび情報

変更履歴

その他のリソース