Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
Um trigger é SQL que roda automaticamente quando uma linha é inserida, atualizada ou excluída. O MySQL dispara os triggers antes ou depois da alteração dos dados, dando acesso aos valores da linha que está sendo gravada.

Criando um Trigger

Um exemplo prático — registrar toda alteração de preço:
Excluir um trigger:
Listar todos os triggers do banco de dados atual:

BEFORE vs AFTER

Um trigger BEFORE INSERT pode definir valores padrão ou rejeitar dados ruins. Um trigger AFTER INSERT pode gravar registros de auditoria depois que a inserção tem sucesso.

Referências NEW e OLD

Modifique os valores de NEW em um trigger BEFORE para alterar o que é gravado:

Vários Triggers por Evento

O MySQL oferece suporte a vários triggers na mesma tabela e no mesmo evento. As palavras-chave FOLLOWS e PRECEDES controlam a ordem de execução:
Sem FOLLOWS/PRECEDES, o MySQL define a ordem de execução pela hora de criação.

Gerando Erros em Triggers

Use SIGNAL para abortar a operação e retornar um erro a quem chamou:
Quando um trigger BEFORE sinaliza um erro, a inserção/atualização/exclusão é abortada — nada é gravado.

Limitações dos Triggers

Os triggers do MySQL têm várias restrições que vale a pena conhecer:
  • Triggers não podem chamar stored procedures que retornam conjuntos de resultados
  • Triggers não podem usar COMMIT, ROLLBACK ou SAVEPOINT diretamente (eles participam da transação ao redor)
  • Triggers não podem referenciar a tabela em que estão definidos (sem chamadas recursivas de trigger por meio de consultas diretas à mesma tabela na maioria dos contextos)
  • Triggers AFTER não podem modificar os valores de NEW — a linha já foi gravada
  • O MySQL não oferece suporte a triggers no nível de instrução (todo trigger é FOR EACH ROW)

Quando Usar Triggers

Os triggers funcionam bem para:
  • Log de auditoria — capturar quem alterou o quê e quando, independentemente da aplicação
  • Impor restrições complexas que as restrições CHECK não conseguem expressar
  • Manter dados derivados sincronizados (colunas de resumo desnormalizadas, timestamps de auditoria)
Evite triggers quando:
  • A lógica é complexa o bastante para que depurá-la exija rastrear efeitos colaterais ocultos
  • O desempenho é crítico — todo trigger dispara por linha, em toda instrução afetada
  • O trigger modifica dados de um jeito que surpreende os desenvolvedores da aplicação que não sabem da existência dele
Triggers ocultos são uma fonte comum da confusão “por que essa linha mudou?”. Se um trigger existe, documente-o com destaque no nível da aplicação, não só no banco de dados.

Perguntas Frequentes

Os triggers disparam durante LOAD DATA INFILE?

Sim. Os triggers INSERT disparam para cada linha carregada por LOAD DATA INFILE. Se o seu trigger faz um trabalho significativo, a carga em massa por LOAD DATA vai ser muito mais lenta do que carregar primeiro em uma tabela de preparação e depois copiar com INSERT…SELECT (que também dispara triggers, mas você pode desabilitá-los temporariamente com SET @disable_trigger = TRUE e uma verificação condicional dentro do trigger).

Os triggers podem chamar stored procedures?

Sim, com uma exceção: a procedure chamada não pode retornar um conjunto de resultados (um SELECT sem INTO). Se retornar, o MySQL gera um erro. As procedures chamadas a partir de triggers podem usar parâmetros OUT e SELECT...INTO.

Os triggers disparam em REPLACE INTO?

REPLACE é executado como um DELETE + INSERT quando há conflito. Em caso de conflito, os quatro disparam na tabela alvo, nesta ordem: BEFORE INSERT (a verificação de chave duplicada), depois BEFORE DELETE e AFTER DELETE para a linha conflitante, e então AFTER INSERT. Como a exclusão é uma exclusão real de linha, as regras ON DELETE CASCADE nas tabelas que a referenciam DISPARAM.

Solução de Problemas

Veja também