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

New state:modified.vars selection method #6222

Draft
wants to merge 14 commits into
base: current
Choose a base branch
from
Draft

New state:modified.vars selection method #6222

Changes from 3 commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
c4505c1
`state:modified.vars` is a new selector, opt-in method behind the `st…
dbeatty10 Oct 2, 2024
00a9928
Fix broken link
dbeatty10 Oct 2, 2024
4ec39bc
Move it up the list
dbeatty10 Oct 2, 2024
6ece7f1
Set the behavior flag to `true`
dbeatty10 Oct 2, 2024
b6548fb
Update state comparison caveats
dbeatty10 Oct 3, 2024
d31c544
`state_modified_compare_vars` behavior change
dbeatty10 Oct 3, 2024
2686dc6
Add `state_modified_compare_vars` behavior change to dbt Cloud releas…
dbeatty10 Oct 3, 2024
ff22cc1
Start to describe the behavior change related to the `state_modified_…
dbeatty10 Oct 3, 2024
496d098
Merge branch 'current' into dbeatty10-patch-4
dbeatty10 Oct 3, 2024
d961c8d
Restore original
dbeatty10 Oct 3, 2024
c688023
Skeleton of behavior change for `state_modified_compare_vars`
dbeatty10 Oct 3, 2024
f337646
Re-add `state_modified_compare_vars` to the upgrade guide
dbeatty10 Oct 3, 2024
534d295
Add a description for the `state_modified_compare_vars` behavior chan…
dbeatty10 Oct 3, 2024
8519885
Fill out the behavior change entry
dbeatty10 Oct 3, 2024
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
1 change: 1 addition & 0 deletions website/docs/reference/node-selection/methods.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -210,6 +210,7 @@ Because state comparison is complex, and everyone's project is different, dbt su
- `state:modified.relation`: Changes to `database`/`schema`/`alias` (the database representation of this node), irrespective of `target` values or `generate_x_name` macros
- `state:modified.persisted_descriptions`: Changes to relation- or column-level `description`, _if and only if_ `persist_docs` is enabled at each level
- `state:modified.macros`: Changes to upstream macros (whether called directly or indirectly by another macro)
- `state:modified.vars`: Changes to [`vars`](/docs/build/project-variables) that a node depends on (available in v1.9 or with [dbt Cloud Versionless](/docs/dbt-versions/upgrade-dbt-version-in-cloud#versionless) via the `state_modified_compare_vars` [behavior flag](/reference/global-configs/behavior-changes))
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is this vars + env_vars? or just vars?

dbeatty10 marked this conversation as resolved.
Show resolved Hide resolved
- `state:modified.contract`: Changes to a model's [contract](/reference/resource-configs/contract), which currently include the `name` and `data_type` of `columns`. Removing or changing the type of an existing column is considered a breaking change, and will raise an error.

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).)
Expand Down
Loading