Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sqlbuild.com/llms.txt

Use this file to discover all available pages before exploring further.

​
sqb rollback

Restores a virtual environment to a prior finalized checkpoint by rebinding its refs and refreshing logical views. Virtual mode only.

​
Usage

sqb rollback [flags]

​
Flags

FlagDescription
--virtual-envTarget VDE name (defaults to active environment name)
--checkpoint-idRestore a specific checkpoint instead of the previous one
--select, -sRoll back specific models only
--excludeExclude specific models
--allow-partial-rollbackAccept a working VDE when partial rollback leaves downstream stale
--include-stale-upstreamsAdd required upstream refs from the checkpoint
--verbose, -vShow uncapped model sets
--varSet project variables

​
Examples

# Roll back to the previous finalized checkpoint
sqb rollback

# Roll back a specific VDE
sqb rollback --virtual-env pr_123

# Roll back to a specific checkpoint
sqb rollback --checkpoint-id <id>

# Partial rollback
sqb rollback --select fact_orders --allow-partial-rollback
See Rollback for details on checkpoints, rollback behavior, and guards.