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 soft delete marca uma linha como excluída em vez de removê-la. A linha permanece na tabela, invisível para a aplicação, restaurável com uma única instrução. É a resposta padrão para “um usuário excluiu algo e quer de volta”, e ele cria dois problemas que vale a pena entender antes de adotá-lo: toda consulta precisa lembrar do filtro, e as restrições de unicidade deixam de significar o que você pensa.

O Padrão Básico

Adicione um timestamp anulável. NULL significa ativa; um timestamp significa excluída, e registra quando:
Prefira um timestamp a um booleano 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 em email bloqueia um novo cadastro para sempre: a linha com soft delete ainda ocupa o valor.
A correção é um truque de índice funcional: faça a chave única cobrir uma coluna que é constante para as linhas ativas e única para as excluídas. Uma coluna gerada faz isso de forma limpa:
Os índices únicos do MySQL permitem qualquer número de 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

Um WHERE 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_scope no Rails, managers no Django, middleware no Prisma). Ative-o em um só lugar em vez de auditar cada consulta.
As chaves estrangeiras também precisam de atenção: um registro pai com soft delete ainda existe, então 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.
Um meio-termo comum: soft delete na ação do usuário, e depois um job agendado faz o hard delete das linhas em que 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