Palauta Delta-taulukot

Delta Laken avulla voit käyttää RESTORE komentoa saadaksesi vanhemman taulutilan taas ajantasaiseksi. RESTORE palauttaa Delta-taulun aiempaan taulukkoversioon tai taulukkotilaan tietyllä aikaleimalla.

Käytä RESTORE sitä, kun sinun täytyy toipua nopeasti huonosta muutoksesta ilman, että rakennaat taulukkoa manuaalisesti uudelleen. Koska Delta-taulukot säilyttävät transaktiohistoriaa, voit usein palata tunnettuun hyvään tilaan yhdellä komennolla.

Mitä RESTORE tekee

RESTORE muuttaa Delta-taulukon nykyistä tilaa niin, että se vastaa aiempaa sitoutunutta versiota.

Voit palauttaa taulukon, kun tarvitset:

  • Palautu vahingossa tapahtuneista poistoista tai päivityksistä
  • Peruuta viallinen MERGE, ylikirjoitus- tai append-operaatio
  • Peruuta skeemamuutos, joka rikkoo alavirran työkuormat
  • Palautuminen virheellisen kirjoitus- tai putkivaiheen aiheuttamasta korruptiosta

Toisin kuin vain luku -versio historiallisessa kyselyssä, RESTORE se muuttaa live-taulukon tilaa, jonka uudet lukijat näkevät.

Syntax

Käytä kumpaakin näistä lomakkeista Delta-taulukon palauttamiseen.

Palauta tiettyyn Delta-taulukkoversioon:

RESTORE TABLE schema_name.table_name TO VERSION AS OF 5

Palauta taulukkotila tiettyyn aikaleimaan:

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

Ennen palautusta tarkista taulukkohistoria, jotta voit valita oikean version:

DESCRIBE HISTORY schema_name.table_name

Yleinen palautusprosessi näyttää tältä:

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

PySpark-metodit DeltaTable suorittavat saman loogisen operaation kuin SQL-komento RESTORE TABLE .

Mitä tapahtuu palautuksen aikana

Kun ajat RESTORE, Delta Lake ei kirjoita kohdeversiota uudelleen paikoilleen. Sen sijaan se luo uuden version Delta-lokiin, joka osoittaa takaisin valitsemaasi versioon tai aikaleimaan liittyviin tietotiedostoihin.

Tällä käytöksellä on muutamia tärkeitä seurauksia:

  • RESTORE luo uuden nykyisen version taulukosta.
  • Palautetun pisteen tiedostot aktivoituvat uudelleen.
  • Tiedostoja ennen palautusta nykyisestä tilasta ei poisteta heti.
  • Nämä nyt viitamattomat tiedostot voi myöhemmin puhdistaa .VACUUM
  • Palautus itsessään tallennetaan versiottuna taulukkomuutoksena.

Koska RESTORE se on versioittu, voit tarkistaa sen taulukkohistoriasta:

DESCRIBE HISTORY schema_name.table_name

RESTORE, aikamatkailu ja VACUUM

RESTORE ja aikamatkailu käyttää samaa Delta-historiaa, mutta ne ratkaisevat eri ongelmia.

  • Käytä aikamatkailua , kun sinun tarvitsee lukea vain vanhempaa dataa muuttamatta nykyistä taulukon tilaa.
  • Käytä RESTORE sitä, kun haluat vanhemman tilan muuttuvan nykyiseksi kaikille uusille luku- ja kirjoituksille.

VACUUM vaikuttaa palautukseen, koska se poistaa viitamattomat tiedostot tallennustilasta. Palautuksen jälkeen aiemmin nykyisen tilan tiedostot jäävät yleensä viittaamattomiksi. Jos et enää tarvitse niitä, voit siivota ne .VACUUM

Käänteinen tilanne on myös tärkeä: VACUUM se voi estää tulevan palautuksen. Jos VACUUM tiedostot on jo poistettu, ne tiedostot, jotka vaaditaan palautettavalle versiolle, RESTORE epäonnistuu, koska taulukkohistorialla ei enää ole pääsyä näihin fyysisiin tiedostoihin.

Rajoitukset

RESTORE toimii vain, kun kohdeversiossa on edelleen kaikki tarvittavat datatiedostot saatavilla.

Pidä nämä rajat mielessä:

  • Voit palauttaa vain versioihin, joiden datatiedostot ovat vielä olemassa.
  • Jos VACUUM tiedostot poistetaan, palautustoiminto epäonnistuu.
  • Palautushistoriaa ohjaavat Delta-säilytysasetukset, mukaan lukien delta.logRetentionDuration, sekä tiedostojen varsinainen säilytys tallennuksessa.
  • Käytännössä sekä transaktiolokin säilytys että tiedostojen säilytys vaikuttavat siihen, kuinka pitkälle voit palauttaa ne taaksepäin.

Parhaat käytännöt

Käytä näitä käytäntöjä riskin vähentämiseksi:

  • Suorita DESCRIBE HISTORY ennen palautusta, jotta voit varmistaa oikean version tai aikaleiman.
  • Käytä ensin aikamatkustuskyselyitä, jos tarvitset vain vanhempaa dataa etkä halua muuttaa nykyistä taulukkotilaa.
  • Suorita VACUUM palautuksen jälkeen, kun haluat puhdistaa viitattomat tiedostot esipalautustilasta.
  • Testaa palautuspolku ensin kloonipöydällä, kun työskentelet kriittisen tuotantodatan kanssa.