Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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:
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:
Um fluxo de trabalho comum de restauro é o seguinte:
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:
-
RESTOREcria 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:
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
RESTOREquando 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
VACUUMesses 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 HISTORYantes 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
VACUUMdepois 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.