Skip to main content
Compare the compiled project with ClickHouse and print a read-only plan.
The effective project mode chooses the planner:
  • Direct mode: plan the requested destructive rebuild. No selector means every model; selectors include downstream closure. Matching objects are not pruned.
  • Virtual environments: plan changed deployment objects, replay roots, and policies against published and staged state.

Selection

Repeat --select to union bare model names and pipeline:<name> selectors:
Graph + syntax, tags, paths, globs, and exclusions are not supported by plan.

Replay controls

The following apply only to virtual environments:
Both require --select and are mutually exclusive.

Common options

Connecting commands accept --host, --port, --username, --password, --database, --target, --vars, and --project-dir. --json emits structured output and --verbose (-v) includes full schema diffs.