Expand description
Compile command — validate project and show deployment plan.
Compiles the project through a multi-stage pipeline:
- Parse — Load and parse SQL files from the project directory.
- Validate — Check project structure and dependencies.
- Build graph — Assemble the dependency-aware project graph.
- Typecheck — Incrementally validate SQL against Materialize. Only objects whose definitions changed since the last build are re-validated; unchanged builds skip typechecking entirely.
- Display — Print the deployment plan with dependencies and SQL.
Functions§
- print_
cluster_ 🔒dependencies - Prints cluster prerequisites inferred from object and index definitions.
- print_
dependency_ 🔒graph - Prints per-object dependency edges for troubleshooting deployment ordering.
- print_
external_ 🔒dependencies - Prints dependencies that are referenced but not declared in this project tree.
- print_
verbose_ 🔒details - Print verbose details about the project (only shown with VERBOSE env var)
- run
- Compile and validate the project, showing the deployment plan.
- run_
inner 🔒 - run_
with_ 🔒fs - Like
runbut uses the providedcrate::fs::FileSystem(typically an overlay built from unsaved editor buffers) instead of constructing a disk-only one. - run_
without_ typecheck - Compile the project without type checking.
- typecheck_
project 🔒 - Perform type checking using the in-process catalog backend.