ASAPPlanner turns SQL, PromQL, and MetricsQL query workloads into legal candidate plans that may use Approximate Streaming Analytics Primitives (ASAPs), such as sketches and exact summaries. It normalizes language-specific queries into a shared representation, enumerates semantically equivalent alternatives, checks each against the queries' accuracy and latency requirements, and selects a physical plan under the deployment's cost model. Downstream systems deploy and execute that plan.
- New to the repository? Read the planner pipeline, then the glossary.
- Want to run a query? Follow Run and inspect a query.
- Want to see how a workload is planned, stage by stage? Use the Stage Viewer.
- Embedding Planner? Use the library API guide.
- Extending Planner? Read the planning stages design, then the ASAP-aware mapping architecture, which maps each stage to its code, then extend ASAP-aware mapping.
- Evaluating a design? Browse the design documentation, developer documentation, and user guides.
The documentation map gives each audience a complete reading path.
cargo build
cargo test --workspace
No external setup is required for the standard build and test suite.