// Referência de erro do SQL Server

Erro do SQL Server 266: Contagem de transações não corresponde após EXECUTE

Um procedimento armazenado ou lote terminou com um número de transações abertas diferente do que tinha no início: um BEGIN TRANSACTION sem COMMIT, ou um ROLLBACK a mais.

Número do erro
266
Gravidade
16
Categoria
Transações e bloqueio
Mensagem de erro
Transaction count after EXECUTE indicates a mismatching number of BEGIN and COMMIT statements. Previous count = %ld, current count = %ld.

O que significa

O SQL Server conta transações abertas em @@TRANCOUNT. Quando um procedimento armazenado, gatilho ou chamada RPC (como sp_executesql) retorna, o SQL Server compara a contagem com o valor que tinha na entrada. Se forem diferentes, ele gera o erro 266 para avisar que o módulo deixou o estado da transação desequilibrado.

O erro é um aviso sobre a forma do código de transação. O trabalho dentro do procedimento já foi executado; o que acontece a seguir depende de o chamador confirmar ou reverter a transação que ainda está aberta ou nunca abriu uma que foi revertida.

Causas comuns

  • Um procedimento executa BEGIN TRANSACTION e retorna antecipadamente (um IF ... RETURN, ou um caminho de erro) sem COMMIT ou ROLLBACK.
  • Um procedimento executa ROLLBACK TRANSACTION dentro de uma transação que seu chamador abriu. ROLLBACK sempre faz rollback para a transação mais externa e define @@TRANCOUNT para 0, então a contagem do chamador não corresponde mais.
  • Uma biblioteca cliente ou uma ferramenta envia um BEGIN TRANSACTION através do sp_executesql (uma chamada RPC) e espera que ele permaneça aberto para instruções posteriores.
  • SET XACT_ABORT ON reverteu toda a transação após um erro em tempo de execução dentro de um procedimento aninhado.

Como corrigir

  1. Verificar @@TRANCOUNT no início do procedimento e somente abrir (e depois fazer commit) uma transação quando não houver uma já existente. Use um ponto de salvamento para trabalho aninhado, assim um erro reverte apenas as próprias alterações do procedimento.

    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. Faça com que cada caminho de saída feche a transação. Substitua o RETURN instruções dentro de uma transação com um salto para uma única saída que faz commit ou rollback.

  3. Quando uma ferramenta ou driver precisar de uma transação através de várias instruções, abra-a com a API de transação do driver ou envie BEGIN TRANSACTION como um lote simples, não como uma sp_executesql chamada.

  4. Se você vir 266 junto com outro erro, corrija primeiro esse outro erro. 266 frequentemente é a segunda mensagem depois que uma falha (por exemplo, 1205 ou 547) fez o procedimento reverter.

Reproduza com segurança

-- 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;

Perguntas

O erro 266 desfaz minhas alterações?

Não. O erro 266 em si não desfaz nada. As alterações feitas dentro do procedimento ainda fazem parte de qualquer transação aberta; elas são mantidas se o chamador fizer commit e desfeitas se fizer rollback. Verifique @@TRANCOUNT imediatamente após a chamada.

Por que recebo 266 da minha aplicação, mas não no SSMS?

Muitos drivers enviam instruções parametrizadas através de sp_executesql, que é uma chamada RPC com a qual o SQL Server verifica se a contagem de transações está equilibrada. O SSMS envia seu texto como um lote simples, então um BEGIN TRANSACTION ali simplesmente permanece aberto.

Erros relacionados

Mais erros de transações e bloqueios

O código e o texto da mensagem são de Referência de eventos e erros do Microsoft Database Engine. Veja toda a Lista de erros do SQL Server ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com SQL Server no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o SQL Server e os outros bancos de dados que você usa.