Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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:
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ę:
Typowy przepływ pracy przywracania wygląda następująco:
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:
-
RESTORETworzy 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:
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
RESTOREpolecenia , 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
VACUUMte 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 HISTORYprzed 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
VACUUMpo 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.