Restaurar tabelas Delta

Com o Delta Lake, podes usar o RESTORE comando para tornar um estado de tabela mais antigo novamente atual. RESTORE repõe uma tabela Delta para uma versão anterior da tabela ou para o estado da tabela numa marca temporal específica.

Usa RESTORE quando precisares de recuperar rapidamente de uma alteração incorreta sem reconstruir manualmente a tabela. Como as tabelas Delta mantêm o histórico das transações, muitas vezes pode reverter para um estado conhecido e bom num único comando.

O que o RESTORE faz

RESTORE altera o estado atual de uma tabela Delta para que corresponda a uma versão confirmada anterior.

Pode restaurar uma tabela quando precisar:

  • Recuperar de eliminações ou atualizações acidentais
  • Desfazer uma operação defeituosa MERGE, sobrescrever ou anexar
  • Reverter uma alteração de esquema que quebra cargas de trabalho a jusante
  • Recuperar da corrupção introduzida por uma escrita ou etapa de pipeline defeituosa

Ao contrário de uma consulta histórica só de leitura, RESTORE altera o estado atual da tabela que é visto pelos novos leitores.

Sintaxe

Use qualquer uma destas formas para restaurar uma tabela Delta.

Restaurar para uma versão específica da tabela Delta:

RESTORE TABLE schema_name.table_name TO VERSION AS OF 5

Restaurar a tabela para o estado numa marca temporal específica:

RESTORE TABLE schema_name.table_name TO TIMESTAMP AS OF '2026-05-01 12:00:00'

Antes de restaurar, inspecione o histórico da tabela para poder escolher a versão correta:

DESCRIBE HISTORY schema_name.table_name

Um fluxo de trabalho comum de restauro é o seguinte:

DESCRIBE HISTORY dbo.orders;
RESTORE TABLE dbo.orders TO VERSION AS OF 42

Os métodos PySpark DeltaTable executam a mesma operação lógica que o comando SQL RESTORE TABLE .

O que acontece durante a restauração

Quando executas RESTORE, Delta Lake não reescreve a versão alvo no local. Em vez disso, cria uma nova versão no registo Delta que aponta para os ficheiros de dados associados à versão ou à data/hora que selecionou.

Esse comportamento tem algumas consequências importantes:

  • RESTORE cria uma nova versão atual da tabela.
  • Os ficheiros do ponto restaurado voltam a estar ativos.
  • Os ficheiros do estado atual anterior ao restauro não são eliminados imediatamente.
  • Esses ficheiros agora sem referência podem ser limpos mais tarde com VACUUM.
  • A restauração em si é registada como uma alteração de tabela versionada.

Como RESTORE é versionado, pode inspecioná-lo no histórico da tabela:

DESCRIBE HISTORY schema_name.table_name

RESTAURAR, viajar no tempo e VÁCUO

RESTORE e a viagem no tempo usam a mesma história do Delta, mas resolvem problemas diferentes.

  • Usa viagem no tempo quando só precisas de ler dados antigos sem alterar o estado atual da tabela.
  • Usa RESTORE quando quiseres que o estado antigo se torne o estado atual para todas as novas leituras e escritas.

VACUUM afeta a recuperação porque remove ficheiros não referenciados do armazenamento. Após uma restauração, os ficheiros do estado atual anterior normalmente deixam de ser referenciados. Se já não precisares deles, podes limpá-los com VACUUM.

O inverso também é importante: VACUUM pode impedir uma restauração futura. Se VACUUM já removeu os ficheiros necessários para a versão que quer recuperar, RESTORE falha porque o histórico da tabela já não tem acesso a esses ficheiros físicos.

Limitações

RESTORE Só funciona quando a versão de destino ainda tem todos os ficheiros de dados necessários disponíveis.

Tenha em mente estes limites:

  • Só pode restaurar versões cujos ficheiros de dados ainda existam.
  • Se VACUUM esses ficheiros forem removidos, a operação de restauro falha.
  • O histórico de restauro é regido pelas definições de retenção do Delta, incluindo delta.logRetentionDuration, e pela retenção efetiva dos ficheiros de dados no armazenamento.
  • Na prática, tanto a retenção de registos de transações como a retenção de ficheiros afetam até onde se pode restaurar.

Práticas recomendadas

Use estas práticas para reduzir o risco:

  • Execute DESCRIBE HISTORY antes de restaurar para confirmar a versão correta ou o carimbo temporal.
  • Use primeiro consultas de viagem no tempo se só precisar de inspecionar dados antigos e não quiser alterar o estado atual da tabela.
  • Executa VACUUM depois de uma restauração quando quiseres limpar ficheiros não referenciados do estado pré-restauro.
  • Teste primeiro o caminho de restauro numa tabela clone quando estiver a trabalhar com dados críticos de produção.