// Referencia de errores de SQL Server

Error 266 de SQL Server: el recuento de transacciones no coincide después de EXECUTE

Un procedimiento almacenado o lote terminó con un número de transacciones abiertas distinto del que tenía al empezar: un BEGIN TRANSACTION sin COMMIT, o un ROLLBACK de más.

Número de error
266
Gravedad
16
Categoría
Transacciones y bloqueo
Mensaje de error
Transaction count after EXECUTE indicates a mismatching number of BEGIN and COMMIT statements. Previous count = %ld, current count = %ld.

Qué significa

SQL Server cuenta las transacciones abiertas en @@TRANCOUNT. Cuando hay un procedimiento almacenado, un desencadenador o una llamada RPC (como sp_executesql) devuelve, SQL Server compara el recuento con el valor que tenía al entrar; si difieren, lanza el 266 para avisarte de que el módulo dejó el estado de la transacción desequilibrado.

El error es una advertencia sobre la forma de tu código de transacciones. El trabajo dentro del procedimiento ya se ejecutó; lo que pase después depende de si quien lo llama confirma o revierte la transacción que sigue abierta, o si nunca abrió una que terminó revertida.

Causas comunes

  • Un procedimiento se ejecuta BEGIN TRANSACTION y termina antes de tiempo (un IF ... RETURN, o una ruta de error) sin COMMIT o ROLLBACK.
  • Un procedimiento se ejecuta ROLLBACK TRANSACTION dentro de una transacción que su llamador abrió. ROLLBACK siempre revierte hasta la transacción más externa y establece @@TRANCOUNT a 0, por lo que el conteo del llamador ya no coincide.
  • Una biblioteca cliente o una herramienta envía un BEGIN TRANSACTION a través de sp_executesql (una llamada RPC) y espera que permanezca abierta para instrucciones posteriores.
  • SET XACT_ABORT ON revirtió toda la transacción después de un error en tiempo de ejecución dentro de un procedimiento anidado.

Cómo solucionarlo

  1. Comprobar @@TRANCOUNT al inicio del procedimiento y solo abrir (y luego confirmar) una transacción cuando no haya una ya. Usa un punto de guardado para el trabajo anidado, de modo que un error revierta únicamente los cambios propios del procedimiento.

    CREATE OR ALTER PROCEDURE dbo.TransferFunds @From int, @To int, @Amount money
    AS
    BEGIN
        SET NOCOUNT ON;
        DECLARE @OwnTran bit = CASE WHEN @@TRANCOUNT = 0 THEN 1 ELSE 0 END;
        IF @OwnTran = 1 BEGIN TRANSACTION;
        ELSE SAVE TRANSACTION TransferFunds;
        BEGIN TRY
            UPDATE dbo.Accounts SET Balance -= @Amount WHERE AccountId = @From;
            UPDATE dbo.Accounts SET Balance += @Amount WHERE AccountId = @To;
            IF @OwnTran = 1 COMMIT TRANSACTION;
        END TRY
        BEGIN CATCH
            IF @OwnTran = 1 AND @@TRANCOUNT > 0 ROLLBACK TRANSACTION;
            ELSE IF XACT_STATE() = 1 ROLLBACK TRANSACTION TransferFunds;
            THROW;
        END CATCH
    END;
  2. Haz que cada punto de salida equilibre la transacción. Reemplaza RETURN instrucciones dentro de una transacción con un salto a una única salida que confirma o revierte.

  3. Cuando una herramienta o controlador necesita una transacción a través de varias instrucciones, ábrela con la API de transacciones del controlador o envía BEGIN TRANSACTION como un lote simple, no como uno parametrizado sp_executesql llamada.

  4. Si ves el 266 junto a otro error, corrige primero ese otro error. El 266 suele ser el segundo mensaje que aparece cuando un fallo (por ejemplo 1205 o 547) provoca la reversión del procedimiento.

Reprodúcelo de forma segura

-- Run on a scratch database.
CREATE OR ALTER PROCEDURE dbo.LeavesTranOpen AS BEGIN TRANSACTION;
GO
EXEC dbo.LeavesTranOpen;   -- Msg 266: Previous count = 0, current count = 1
SELECT @@TRANCOUNT;        -- 1: the transaction is still open
ROLLBACK;
DROP PROCEDURE dbo.LeavesTranOpen;

Preguntas

¿El error 266 revierte mis cambios?

No. El 266 por sí mismo no revierte nada. Los cambios realizados dentro del procedimiento siguen siendo parte de la transacción abierta; se mantienen si el llamador hace commit y se deshacen si hace rollback. Comprueba @@TRANCOUNT justo después de la llamada.

¿Por qué obtengo 266 desde mi aplicación pero no en SSMS?

Muchos controladores envían instrucciones parametrizadas a través de sp_executesql, que es una llamada RPC con la que SQL Server comprueba que el recuento de transacciones esté equilibrado. SSMS envía tu texto como un lote simple, así que un BEGIN TRANSACTION simplemente permanece abierto.

Errores relacionados

Más errores de transacciones y bloqueos

El código y el texto del mensaje son de Referencia de eventos y errores del motor de base de datos de Microsoft. Explora la lista completa de Lista de errores de SQL Server o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con SQL Server en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para SQL Server y las demás bases de datos que uses.