Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Adding new state selectors #3596

Merged
merged 10 commits into from
Jul 6, 2023
Merged

Adding new state selectors #3596

Changes from 2 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
a7dc43b
Adding new state selectors
matthewshaver Jun 21, 2023
98bbacf
Update website/docs/reference/node-selection/methods.md
matthewshaver Jul 5, 2023
c7f8c39
Update website/docs/reference/node-selection/methods.md
matthewshaver Jul 5, 2023
4b09ded
Update website/docs/reference/node-selection/methods.md
matthewshaver Jul 5, 2023
5e646d5
Update website/docs/reference/node-selection/methods.md
matthewshaver Jul 5, 2023
20e382c
Update website/docs/reference/node-selection/methods.md
matthewshaver Jul 5, 2023
57346d4
Update website/docs/reference/node-selection/methods.md
matthewshaver Jul 6, 2023
ca70888
Update website/docs/reference/node-selection/methods.md
matthewshaver Jul 6, 2023
be2a904
Update website/docs/reference/node-selection/methods.md
matthewshaver Jul 6, 2023
b030eb9
Merge branch 'current' into new-state
matthewshaver Jul 6, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion website/docs/reference/node-selection/methods.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -178,7 +178,7 @@ The `state` method is used to select nodes by comparing them against a previous

</VersionBlock>

`state:new`: There is no node with the same `unique_id` in the comparison manifest
`state:new`: There is no node with the same `unique_id` in the comparison manifest.
matthewshaver marked this conversation as resolved.
Show resolved Hide resolved

`state:modified`: All new nodes, plus any changes to existing nodes.

Expand All @@ -200,6 +200,16 @@ Because state comparison is complex, and everyone's project is different, dbt su

Remember that `state:modified` includes _all_ of the criteria above, as well as some extra resource-specific criteria, such as modifying a source's `freshness` or `quoting` rules or an exposure's `maturity` property. (View the source code for the full set of checks used when comparing [sources](https://github.com/dbt-labs/dbt-core/blob/9e796671dd55d4781284d36c035d1db19641cd80/core/dbt/contracts/graph/parsed.py#L660-L681), [exposures](https://github.com/dbt-labs/dbt-core/blob/9e796671dd55d4781284d36c035d1db19641cd80/core/dbt/contracts/graph/parsed.py#L768-L783), and [executable nodes](https://github.com/dbt-labs/dbt-core/blob/9e796671dd55d4781284d36c035d1db19641cd80/core/dbt/contracts/graph/parsed.py#L319-L330).)

<VersionBlock firstVersion="1.6">

There are two additional `state` selectors that complement `state:new` and `state:modified` by representing the inverse of those functions:
- `state:old` &mdash; a node with the same `unique_id` exists in the comparison manifest
matthewshaver marked this conversation as resolved.
Show resolved Hide resolved
- `state:unmodified`: All existing nodes with no changes
matthewshaver marked this conversation as resolved.
Show resolved Hide resolved

The benefits for these selectors are primarily to exclude unchanged nodes to shorten run times. There are no subselectors available, but that may change as use cases evolve.
matthewshaver marked this conversation as resolved.
Show resolved Hide resolved

</VersionBlock>

### The "exposure" method

The `exposure` method is used to select parent resources of a specified [exposure](/docs/build/exposures). Use in conjunction with the `+` operator.
Expand Down