// Referência de erro do SQL Server

Erro do SQL Server 3609: Transação encerrada no gatilho

Um gatilho executou ROLLBACK (ou um erro dentro dele fez rollback), o que desfaz toda a transação e aborta o restante do lote.

Número do erro
3609
Gravidade
16
Categoria
Transações e bloqueio
Mensagem de erro
The transaction ended in the trigger. The batch has been aborted.

O que significa

Um gatilho é executado dentro da transação da instrução que o acionou. Se o gatilho emitir ROLLBACK TRANSACTION, tudo na transação é desfeito, incluindo o trabalho feito antes da instrução que disparou o evento, e o SQL Server aborta o lote com 3609. Triggers que validam dados frequentemente fazem isso de propósito; o 3609 apenas informa que o lote foi interrompido.

Causas comuns

  • Um gatilho que aplica uma regra de negócios com ROLLBACK quando a regra é violada.
  • Um erro dentro do gatilho que, com XACT_ABORT (que está ativado por padrão dentro de triggers), desfaz a transação.
  • Chamadores que não esperam um gatilho na tabela e assumem que sua transação ainda está aberta.

Como corrigir

  1. Leia a mensagem que o gatilho gerou pouco antes do 3609; geralmente explica a regra que foi violada.

  2. Prefere gerar um erro com THROW no gatilho e deixar o chamador decidir, ou impor a regra com um CHECK ou restrição de chave estrangeira em vez disso.

    CREATE OR ALTER TRIGGER dbo.trg_Orders_NoNegative ON dbo.Orders AFTER INSERT, UPDATE AS
    BEGIN
        IF EXISTS (SELECT 1 FROM inserted WHERE Quantity < 0)
            THROW 50001, 'Quantity cannot be negative.', 1;
    END;
  3. Liste os gatilhos em uma tabela para descobrir o que está sendo executado.

    SELECT name, is_disabled FROM sys.triggers WHERE parent_id = OBJECT_ID(N'dbo.Orders');

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.