EddytorDocs & API
07 · Tables A→ZI · Version, time-travel & recover

Roll back to a version number

Reset a table to an earlier Delta version. Destructive - discards everything after it.

rollback_table resets a table to an earlier version number. Use it when you know the exact good version (from the history).

Heads up

Destructive: all versions after the target are discarded. This is not a new commit layered on top - the forward history is truncated. Always read the history and confirm before running it.

Roll back

eddytor rollback table eddytor sales orders --version 41
rollback_table(table="eddytor.cfg_xxx.<uuid>_orders", version=41)

Open the table → History → select the target version → Roll back.

Find the target version first with eddytor get history (or get_table_history).

Safe procedure

  1. get_table_history → identify the last good version number (mind that OPTIMIZE/VACUUM are versions too).
  2. Optionally diff_table_versions to confirm what you're undoing.
  3. Confirm - there's no undo.
  4. rollback_table(table, version=N).
  5. profile_table + validate_constraints → confirm the restored state.

Heads up

You can't roll back past a version whose files vacuum has pruned (default retention 168h / 7 days).

Rollback vs restore

Use rollback for a known version number; use restore for an approximate timestamp. Both discard later versions - see the comparison.

Next

On this page