VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
O Padrão Básico
Adicione um timestamp anulável.NULL significa ativa; um timestamp significa excluída, e registra quando:
deleted: custa o mesmo e responde “quando” de graça, que é o que o ticket de suporte vai perguntar.
Problema 1: Restrições de Unicidade
Um índice único ememail bloqueia um novo cadastro para sempre: a linha com soft delete ainda ocupa o valor.
NULLs, então as linhas excluídas nunca colidem, enquanto duas linhas ativas com o mesmo email ainda falham. Consulte Colunas geradas para o mecanismo.
Problema 2: Toda Consulta Precisa Lembrar
UmWHERE deleted_at IS NULL esquecido e dados excluídos vazam para um relatório ou para uma resposta de API. Duas mitigações:
- Uma view para o subconjunto ativo. Aponte os caminhos de leitura para a view e o filtro não pode ser esquecido:
- Escopos de ORM. A maioria dos ORMs consegue aplicar o filtro globalmente (
default_scopeno Rails, managers no Django, middleware no Prisma). Ative-o em um só lugar em vez de auditar cada consulta.
ON DELETE CASCADE nunca dispara. Se os filhos devem desaparecer junto com o pai, a aplicação (ou um trigger) precisa propagar o deleted_at por conta própria.
Quando Não Usar Soft Delete
- Exclusão regulatória. Um pedido de exclusão sob o GDPR significa que os dados se foram, não que estão ocultos. Linhas com soft delete ainda contam como dados pessoais.
- Tabelas de alta rotatividade. Sessões, jobs de fila e logs excluídos aos milhões apenas incham a tabela e todos os índices dela.
- Dados que ninguém vai restaurar. Se não existe um caso de uso para desfazer, o custo do filtro não traz nenhum benefício.
deleted_at é mais antigo do que a janela de retenção:
Veja também
- Colunas geradas — o mecanismo por trás da correção da restrição de unicidade
- Views — uma view de linhas ativas que não pode esquecer o filtro
- Chaves estrangeiras — por que as cascatas não disparam em soft deletes
- DELETE no MySQL — o hard delete que este padrão substitui