Skip to content

Commit ba03be1

Browse files
committed
docs(dag-viewer): note not-judged candidates and the scalar_roots check
1 parent c7f98b0 commit ba03be1

1 file changed

Lines changed: 4 additions & 3 deletions

File tree

‎tools/dag-viewer/README.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,13 +22,14 @@ To run it, see [RUNNING.md](RUNNING.md).
2222
line that counts the candidates at each stage.
2323
- **Stage 3 · plans by cost**: every candidate the document shows. First the
2424
selected plan, then the other valid ones cheapest first, then the
25-
rejected ones with their reasons, then the Stage 2 pruned ones and the
25+
rejected ones with their reasons (or "not judged" when plan selection
26+
failed with an error), then the Stage 2 pruned ones and the
2627
Stage 1 candidates that did not compose, each with its reason. The header
2728
says how many candidates Stage 1 enumerated, how many the document shows
2829
when it caps them, and why Stage 1 or plan selection failed when it did.
2930
Clicking a row shows it in the lanes.
3031
- **Three lanes**, stacked top to bottom so each is as wide as the page:
31-
Stage 0, the chosen Stage 1 candidate, and the chosen Stage 2 candidate
32+
Stage 0, the chosen Stage 1 candidate, and its Stage 2 candidate
3233
with each node's timing and Stage 3 cost (`× n` when a node that is not
3334
materialized is computed once per reader). Each lane is the whole
3435
workload's DAG, so a node shared by several queries appears once. Nodes
@@ -91,7 +92,7 @@ time column). The server runs `stage_pipeline` with `--sql`, `--promql`,
9192
fails, `selected` is null, with the rejections or with `error`.
9293

9394
The viewer checks the document before showing it: one root per query, node,
94-
edge and root references, `from_logical`, and the Stage 3 ids, costs and
95+
edge and root references, `scalar_roots` positions, `from_logical`, and the Stage 3 ids, costs and
9596
`per_node` keys. If a check fails, it shows the problems instead.
9697

9798
## Files

0 commit comments

Comments
 (0)