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
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 TRANSACTIONe retorna antecipadamente (umIF ... RETURN, ou um caminho de erro) semCOMMITouROLLBACK. - Um procedimento executa
ROLLBACK TRANSACTIONdentro de uma transação que seu chamador abriu.ROLLBACKsempre faz rollback para a transação mais externa e define@@TRANCOUNTpara 0, então a contagem do chamador não corresponde mais. - Uma biblioteca cliente ou uma ferramenta envia um
BEGIN TRANSACTIONatravés dosp_executesql(uma chamada RPC) e espera que ele permaneça aberto para instruções posteriores. SET XACT_ABORT ONreverteu toda a transação após um erro em tempo de execução dentro de um procedimento aninhado.
Como corrigir
-
Verificar
@@TRANCOUNTno 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; -
Faça com que cada caminho de saída feche a transação. Substitua o
RETURNinstruções dentro de uma transação com um salto para uma única saída que faz commit ou rollback. -
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 TRANSACTIONcomo um lote simples, não como umasp_executesqlchamada. -
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
3902COMMIT não tem um BEGIN correspondente3903ROLLBACK não tem um BEGIN correspondente3930A transação não pode ser confirmada1205Em deadlock e escolhido como vítima3609Transação encerrada no gatilho
Mais erros de transações e bloqueios
1222O período de tempo limite da solicitação de bloqueio foi excedido3960Conflito de atualização com isolamento de snapshot3616Erro gerado durante a execução do gatilho6401Nenhuma transação ou ponto de salvamento encontrado3998Transação não confirmável revertida3621A instrução foi encerrada
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.
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.