0Pricing
SQL Academy · Aula

Anatomia de gatilhos: BEFORE/AFTER, FOR EACH ROW

Entenda o momento de execução e a granularidade dos gatilhos (linha ou instrução), além do significado de NEW e OLD dentro de uma função de gatilho.

Anatomia de gatilhos: BEFORE/AFTER, FOR EACH ROW é uma aula grátis de SQL Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de SQL Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de SQL Academy inclui 4 aulas no total.

O que é um gatilho

Um gatilho é uma função que o banco de dados chama automaticamente antes ou depois de um INSERT, UPDATE, DELETE ou TRUNCATE em uma tabela.

Duas partes: função + gatilho

Você escreve uma função que retorna trigger e depois a associa a uma tabela:

CREATE OR REPLACE FUNCTION set_updated_at()
RETURNS TRIGGER AS $$
BEGIN
  NEW.updated_at := NOW();
  RETURN NEW;
END;
$$ LANGUAGE plpgsql;

CREATE TRIGGER trg_set_updated_at
BEFORE UPDATE ON users
FOR EACH ROW EXECUTE FUNCTION set_updated_at();

BEFORE versus AFTER

  • BEFORE — é acionado antes de a linha ser gravada; pode modificar NEW
  • AFTER — é acionado depois da gravação; serve para efeitos colaterais (auditoria, notificações)

FOR EACH ROW versus FOR EACH STATEMENT

  • FOR EACH ROW — é executado uma vez por linha afetada; NEW e OLD ficam disponíveis
  • FOR EACH STATEMENT — é executado uma vez por instrução, sem acesso individual às linhas

NEW e OLD

Dentro de um gatilho de linha:

  • NEW — a nova linha (INSERT, UPDATE)
  • OLD — a linha anterior (UPDATE, DELETE)

O valor de retorno importa

Para gatilhos de linha BEFORE:

  • Retorne NEW para prosseguir com essa linha
  • Retorne um NEW modificado para alterar o que será armazenado
  • Retorne NULL para cancelar a operação nessa linha

Filtro WHEN

Acionamento condicional:

CREATE TRIGGER trg_log_status
AFTER UPDATE OF status ON orders
FOR EACH ROW WHEN (OLD.status IS DISTINCT FROM NEW.status)
EXECUTE FUNCTION log_status_change();

OF coluna

BEFORE/AFTER UPDATE pode ser acionado somente quando colunas específicas forem alteradas:

CREATE TRIGGER ... AFTER UPDATE OF status ON orders ...

Vários gatilhos

Os gatilhos são acionados em ordem alfabética pelo nome do gatilho. Use prefixos (00_, 10_, ...) para controlar a ordem.

Desempenho dos gatilhos

Gatilhos de linha são acionados uma vez por linha — lógica pesada dentro de um gatilho de linha × um DML grande = lentidão. Prefira gatilhos de instrução para efeitos colaterais em massa.

Desativando gatilhos

Ignore temporariamente:

ALTER TABLE orders DISABLE TRIGGER trg_audit;
-- bulk load...
ALTER TABLE orders ENABLE TRIGGER trg_audit;

-- Disable ALL triggers (use carefully):
ALTER TABLE orders DISABLE TRIGGER ALL;

Recursão de gatilhos

Um UPDATE acionado por um gatilho na mesma tabela aciona o gatilho novamente. Use proteções (pg_trigger_depth()) ou projete com cuidado.

Recapitulação

Os gatilhos automatizam reações por linha.

  • Função que retorna TRIGGER + CREATE TRIGGER
  • BEFORE para modificar, AFTER para efeitos colaterais
  • NEW/OLD para acessar linhas
  • WHEN e OF coluna para aumentar a seletividade

Verificação rápida

Você quer atualizar automaticamente uma coluna updated_at a cada alteração de linha. Qual configuração de gatilho deve usar?

Perguntas Frequentes

A aula “Anatomia de gatilhos: BEFORE/AFTER, FOR EACH ROW” é grátis?

Sim — o texto completo de “Anatomia de gatilhos: BEFORE/AFTER, FOR EACH ROW” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de SQL Academy, atualize para CoddyKit PRO. O curso de SQL Academy inclui 4 aulas no total.

O que vou aprender em “Anatomia de gatilhos: BEFORE/AFTER, FOR EACH ROW”?

Entenda o momento de execução e a granularidade dos gatilhos (linha ou instrução), além do significado de NEW e OLD dentro de uma função de gatilho. Você pratica SQL Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar SQL Academy?

Nenhuma experiência prévia é necessária. SQL Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.

Quanto tempo leva a aula “Anatomia de gatilhos: BEFORE/AFTER, FOR EACH ROW”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de SQL Academy?

Sim. Cada aula de SQL Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Anatomia de gatilhos: BEFORE/AFTER, FOR EACH ROW
  2. Fundamentos de funções PL/pgSQL
  3. Blocos DO e código anônimo
  4. Auditoria de tabelas com gatilhos
← Voltar para SQL Academy