VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
Criando um Trigger
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-chaveFOLLOWS e PRECEDES controlam a ordem de execução:
FOLLOWS/PRECEDES, o MySQL define a ordem de execução pela hora de criação.
Gerando Erros em Triggers
UseSIGNAL para abortar a operação e retornar um erro a quem chamou:
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,ROLLBACKouSAVEPOINTdiretamente (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
AFTERnão podem modificar os valores deNEW— 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)
- 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
Perguntas Frequentes
Os triggers disparam durante LOAD DATA INFILE?
Sim. Os triggersINSERT 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 (umSELECT 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
- Stored Procedures no MySQL — lógica que os triggers podem chamar
- Enviando Webhooks a partir de Triggers — chamadas HTTP a partir do corpo de triggers
- Restrições CHECK no MySQL — uma alternativa mais simples para as regras de validação que os triggers costumam implementar