Przywracanie tabel Delta

Za pomocą usługi Delta Lake możesz ponownie użyć RESTORE polecenia , aby ponownie ustawić stan starszej tabeli. RESTORE Przywraca tabelę delty do poprzedniej wersji tabeli lub stanu tabeli w określonym znaczniku czasu.

Użyj polecenia RESTORE, gdy musisz szybko cofnąć nieudaną zmianę bez ręcznego przebudowywania tabeli. Ponieważ tabele Delta przechowują historię transakcji, często można cofnąć je do znanego, poprawnego stanu za pomocą jednego polecenia.

Co funkcja RESTORE robi

RESTORE zmienia bieżący stan tabeli delty, aby była zgodna z wcześniej zatwierdzoną wersją.

Tabelę można przywrócić, gdy musisz:

  • Odzyskiwanie po przypadkowych usunięciach lub aktualizacjach
  • Cofanie błędnej MERGE, operacji nadpisania lub dopisania
  • Wycofaj zmianę schematu, która zakłóca działanie zależnych obciążeń roboczych
  • Odzyskać po uszkodzeniu spowodowanym przez błędny zapis lub etap potoku

W przeciwieństwie do zapytania historycznego tylko do odczytu, RESTORE zmienia bieżący stan tabeli widoczny dla nowych czytelników.

Składnia

Użyj jednej z tych formularzy, aby przywrócić tabelę delty.

Przywróć określoną wersję tabeli delty:

RESTORE TABLE schema_name.table_name TO VERSION AS OF 5

Przywróć stan tabeli w określonym znaczniku czasu:

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

Przed przywróceniem sprawdź historię tabel, aby można było wybrać poprawną wersję:

DESCRIBE HISTORY schema_name.table_name

Typowy przepływ pracy przywracania wygląda następująco:

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

Metody PySpark DeltaTable wykonują tę samą operację logiczną co polecenie SQL RESTORE TABLE .

Co się stanie podczas przywracania

Po uruchomieniu polecenia RESTOREusługa Delta Lake nie zapisuje ponownie wersji docelowej. Zamiast tego tworzy nową wersję w dzienniku Delta, która odwołuje się do plików danych skojarzonych z wybraną wersją lub znacznikiem czasu.

To zachowanie ma kilka ważnych konsekwencji:

  • RESTORE Tworzy nową bieżącą wersję tabeli.
  • Pliki z przywróconego punktu ponownie stają się aktywne.
  • Pliki ze stanu bieżącego przywracania wstępnego nie są natychmiast usuwane.
  • Te pliki niezreferencyjne można wyczyścić później za pomocą polecenia VACUUM.
  • Samo przywrócenie jest rejestrowane jako zmiana w wersjonowanej tabeli.

Ponieważ RESTORE jest wersjonowana, możesz sprawdzić ją w historii tabeli:

DESCRIBE HISTORY schema_name.table_name

RESTORE, podróż w czasie i VACUUM

RESTORE i podróże czasowe korzystają z tej samej historii delty, ale rozwiązują różne problemy.

  • Użyj podróży czasowej , gdy trzeba tylko odczytywać starsze dane bez zmieniania bieżącego stanu tabeli.
  • Użyj RESTORE polecenia , jeśli chcesz, aby starszy stan stał się bieżącym stanem dla wszystkich nowych operacji odczytu i zapisu.

VACUUM ma wpływ na odzyskiwanie, ponieważ usuwa nieużywane pliki z magazynu. Po przywróceniu pliki z poprzedniego bieżącego stanu zwykle stają się nieużywane. Jeśli już ich nie potrzebujesz, możesz je wyczyścić za pomocą polecenia VACUUM.

Równie ważne jest też coś odwrotnego: VACUUM może uniemożliwić przyszłe przywrócenie. Jeśli VACUUM usunęło już pliki wymagane dla wersji, którą chcesz odzyskać, RESTORE kończy się niepowodzeniem, ponieważ historia tabeli nie ma już dostępu do tych fizycznych plików.

Ograniczenia

RESTORE Działa tylko wtedy, gdy wersja docelowa nadal ma wszystkie wymagane pliki danych.

Należy pamiętać o tych limitach:

  • Można przywrócić tylko do wersji, których pliki danych nadal istnieją.
  • Jeśli VACUUM te pliki zostaną usunięte, operacja przywracania zakończy się niepowodzeniem.
  • Historia przywróceń jest regulowana przez ustawienia retencji Delta, w tym delta.logRetentionDuration, oraz przez rzeczywisty okres przechowywania plików danych w pamięci masowej.
  • W praktyce zarówno przechowywanie dziennika transakcji, jak i przechowywanie plików mają wpływ na to, jak daleko można przywrócić.

Najważniejsze wskazówki

Skorzystaj z tych rozwiązań, aby zmniejszyć ryzyko:

  • Uruchom polecenie DESCRIBE HISTORY przed przywróceniem, aby potwierdzić odpowiednią wersję lub znacznik czasu.
  • Najpierw użyj zapytań dotyczących podróży czasowych, jeśli potrzebujesz tylko sprawdzić starsze dane i nie chcesz zmieniać bieżącego stanu tabeli.
  • Uruchom polecenie VACUUM po przywróceniu, gdy chcesz wyczyścić niereferencyjne pliki ze stanu przywracania wstępnego.
  • Najpierw przetestuj ścieżkę przywracania na tabeli klonów, gdy pracujesz z krytycznymi danymi produkcyjnymi.