Compartir vía

Obtener acceso a la transacción actual

  • Artículo

Se aplica a: SQL Server

Si una transacción está activa en el momento en el que se escribe código de Common Language Runtime (CLR) que se ejecuta en SQL Server, la transacción se expone a través de la clase System.Transactions.Transaction . La propiedad Transaction.Current permite obtener acceso a la transacción actual. En la mayoría de los casos, no es necesario obtener acceso a la transacción de forma explícita. Para las conexiones de bases de datos, ADO.NET comprueba Transaction.Current de forma automática cuando se llama al método Connection.Open y da de alta la conexión en esa transacción de forma transparente (a menos que la palabra clave Enlist esté establecida en False en la cadena de conexión).

Es posible que desee usar directamente el objeto Transaction en los escenarios siguientes:

  • Si desea dar de alta un recurso que no se da de alta de manera automática o que, por alguna razón, no se haya dado de alta durante la inicialización.

  • Si desea dar de alta un recurso de forma explícita en la transacción.

  • Si desea finalizar la transacción externa desde el interior de su función o procedimiento almacenado. En este caso, use TransactionScope. Por ejemplo, el código siguiente revertirá la transacción actual:

    using(TransactionScope transactionScope = new TransactionScope(TransactionScopeOptions.Required)) { }

En el resto de este tema se describen otras formas de cancelar una transacción externa.

Cancelar una transacción externa

Puede cancelar las transacciones externas de una función o de un procedimiento administrado de las siguientes formas:

  • La función o el procedimiento administrado puede devolver un valor utilizando un parámetro de salida. El procedimiento transact-SQL que realiza la llamada puede comprobar el valor devuelto y, si procede, ejecutar ROLLBACK TRANSACTION.

  • La función o el procedimiento administrado puede iniciar una excepción personalizada. El procedimiento Transact-SQL que realiza la llamada puede detectar la excepción producida por el procedimiento administrado o la función en un bloque try/catch y ejecutar ROLLBACK TRANSACTION.

  • La función o el procedimiento administrado puede cancelar la transacción actual llamando al método Transaction.Rollback si se cumple una condición determinada.

Cuando se llama al método Transaction.Rollback dentro de una función o de un procedimiento administrado, éste inicia una excepción con un mensaje de error ambiguo y puede colocarse dentro de un bloque try/catch. El mensaje de error es similar al siguiente:

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.

Se espera esta excepción y el bloque try/catch resulta necesario para que continúe la ejecución del código. Sin el bloque try/catch, la excepción se iniciará inmediatamente en el procedimiento transact-SQL que realiza la llamada y finalizará la ejecución de código administrado. Cuando finaliza la ejecución del código administrado, se inicia otra excepción:

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.

Esta excepción también se espera y, para que la ejecución continúe, debe tener un bloque try/catch alrededor de la instrucción Transact-SQL que realiza la acción que desencadena el desencadenador. A pesar de las dos excepciones iniciadas, la transacción se revierte y no se confirman los cambios.

Ejemplo

A continuación se muestra un ejemplo de una transacción que se revierte desde un procedimiento administrado mediante el uso del método Transaction.Rollback . Observe el bloque try/catch alrededor del método Transaction.Rollback en el código administrado. El script transact-SQL crea un ensamblado y un procedimiento almacenado administrado. Tenga en cuenta que la instrucción EXEC uspRollbackFromProc se incluye en un bloque try/catch, de modo que la excepción iniciada se detecta al completarse la ejecución del procedimiento administrado.

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 correctly.                      
         }    
      }  
  
      // Close the connection.  
      connection.Close();  
   }  
}  
};  

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 correctly.                      
      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

Consulte también

Integración CLR y transacciones