Selector guide

The box above the viewer’s overview graph filters it with selectors. The syntax is deliberately close to dbt’s --select, so if you have used that you already know most of it. This page is the whole grammar.

clean+ -report        what clean feeds, except the report
+drift_flags          everything drift_flags depends on
ingest_*,+report      ingest targets that sit upstream of the report

Filtering hides the nodes it does not select and refits the view. To keep the whole graph and only fade the rest, click a node instead — see Follow a chain. The two share one definition of upstream and downstream.

1 The pieces

A selector is made of terms. A term is a name, optionally with a + on either side saying how far to follow the dependency edges from it.

Term Selects
clean that target
+clean clean and everything upstream of it
clean+ clean and everything downstream of it
+clean+ clean, everything upstream and everything downstream
2+clean clean and what is up to 2 steps upstream
clean+2 clean and what is up to 2 steps downstream
ingest_* every target whose name matches (* matches any run of characters)
*_flags the same, anchored at the end
-raw_path removes raw_path from the result
-clean+ removes clean and everything downstream of it

“Upstream” follows the edges backwards only, and “downstream” forwards only. A helper function shared by a dozen targets is upstream of each of them, but it does not make the other eleven upstream of one another.

Names are matched exactly and case-sensitively; only * is special.

2 Combining terms

Write Meaning
a b — a space union: what a selects or what b selects
a,b — a comma intersection: only what both select
-x anywhere removed from the final result

Spaces bind loosest, so a,b c is (a and b) or c.

An intersection is how you ask for the nodes on the way between two points. Downstream of clean and upstream of report is exactly the chain connecting them:

clean+,+report

If nothing is left to select, the box says nothing matches and leaves the graph as it was.

3 Recipes

To see Write
Everything affected if clean changes clean+
Everything report is built from +report
The path from clean to report clean+,+report
One stage of a larger pipeline model_*
A stage and what it directly feeds model_*+1
Everything except the ingest stage -ingest_*
The neighbourhood of one target, 2 steps each way 2+drift_model+2
Two unrelated areas side by side ingest_* report

4 Differences from dbt

The syntax is a subset, adapted to a box rather than command-line flags.

dbt tardoc
Union space space
Intersection comma comma
Exclusion a separate --exclude flag a leading - on a term
+ and depth (2+x, x+2) yes yes
@x (x, its descendants, and their ancestors) yes no
Selecting by tag, path, resource type, config.* yes no — names and wildcards only
Graph operators between whole selections yes no

A target’s name is the only thing a selector can see. Grouping by the file a target is declared in is the group toggle, not a selector.

5 Behaviour worth knowing