Delta テーブルを復元

Delta Lake では、 RESTORE コマンドを使用して、古いテーブルの状態を再び最新にすることができます。 RESTORE は、Delta テーブルを以前のテーブル バージョンまたは特定のタイムスタンプのテーブルの状態に戻します。

テーブルを手動で再構築せずに、不適切な変更から迅速に復旧する必要がある場合は、 RESTORE を使用します。 デルタ テーブルはトランザクション履歴を保持するため、多くの場合、1 つのコマンドで既知の正常な状態にロールバックできます。

RESTORE の機能

RESTORE は、以前にコミットされたバージョンと一致するように Delta テーブルの現在の状態を変更します。

次の必要がある場合は、テーブルを復元できます。

  • 誤って削除または更新から回復する
  • 誤った MERGE、上書き、または追加操作を元に戻す
  • ダウンストリーム ワークロードを中断するスキーマ変更をロールバックする
  • 障害のある書き込みまたはパイプラインステップによって発生した破損から復旧する

読み取り専用の履歴クエリとは異なり、 RESTORE は、新しいリーダーに表示されるライブ テーブルの状態を変更します。

Syntax

デルタ テーブルを復元するには、次のいずれかの形式を使用します。

特定の Delta テーブル バージョンに復元します。

RESTORE TABLE schema_name.table_name TO VERSION AS OF 5

特定のタイムスタンプでテーブルの状態に復元します。

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

復元する前に、テーブル履歴を調べて、正しいバージョンを選択できるようにします。

DESCRIBE HISTORY schema_name.table_name

一般的な復元ワークフローは次のようになります。

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

PySpark DeltaTable メソッドは、SQL RESTORE TABLE コマンドと同じ論理操作を実行します。

復元中の動作

RESTOREを実行しても、Delta Lake はターゲット バージョンを書き換えません。 代わりに、選択したバージョンまたはタイムスタンプに関連付けられているデータ ファイルを指す新しいバージョンが Delta ログに作成されます。

その動作には、いくつかの重要な結果があります。

  • RESTORE は、テーブルの新しい現在のバージョンを作成します。
  • 復元されたポイントのファイルが再びアクティブになります。
  • 復元前の現在の状態のファイルはすぐには削除されません。
  • 現在参照されていないファイルは、後で VACUUMでクリーンアップできます。
  • 復元自体は、バージョン管理されたテーブルの変更として記録されます。

RESTOREはバージョン管理されているため、テーブル履歴で調べることができます。

DESCRIBE HISTORY schema_name.table_name

RESTORE、Time Travel、VACUUM

RESTORE とタイムトラベルは同じデルタ履歴を使用しますが、異なる問題を解決します。

  • 現在のテーブルの状態を変更せずに古いデータのみを読み取る必要がある場合は、 タイム トラベル を使用します。
  • 古い状態をすべての新しい読み取りと書き込みの現在の状態にする場合は、 RESTORE を使用します。

VACUUM は、参照されていないファイルをストレージから削除するため、回復に影響します。 復元後、以前の現在の状態のファイルは通常、参照されなくなります。 不要になった場合は、 VACUUMでクリーンアップできます。

逆の方法も重要です。 VACUUM 将来の復元を妨げる可能性があります。 回復するバージョンに必要なファイル VACUUM 既に削除されている場合、テーブル履歴がそれらの物理ファイルにアクセスできなくなったため、 RESTORE は失敗します。

制限事項

RESTORE は、ターゲット バージョンに必要なすべてのデータ ファイルがまだ使用可能な場合にのみ機能します。

次の制限に注意してください。

  • データ ファイルがまだ存在するバージョンにのみ復元できます。
  • これらのファイル VACUUM 削除された場合、復元操作は失敗します。
  • 復元履歴は、delta.logRetentionDurationを含む Delta の保持設定と、ストレージ内のデータ ファイルの実際の保持期間によって決まります。
  • 実際には、トランザクション ログのリテンション期間とファイルリテンション期間の両方が、復元できる期間に影響します。

ベスト プラクティス

リスクを軽減するには、次のプラクティスを使用します。

  • 復元する前に DESCRIBE HISTORY を実行して、適切なバージョンまたはタイムスタンプを確認できるようにします。
  • 古いデータのみを検査する必要があり、現在のテーブルの状態を変更したくない場合は、最初にタイムトラベル クエリを使用します。
  • 復元前の状態から参照されていないファイルをクリーンアップする場合は、復元後に VACUUM を実行します。
  • 重要な本番データを扱う際は、まずクローンテーブルで復元パスをテストしてください。