Skip to content

Commit

Permalink
Updated breaking changes section (#6119)
Browse files Browse the repository at this point in the history
Closes #5574

Following this Git issue:
https://github.com/orgs/dbt-labs/projects/14/views/35?pane=issue&itemId=65030468,
i've created this PR regarding the updated breaking changes

## What are you changing in this pull request and why?
<!--
Describe your changes and why you're making them. If related to an open
issue or a pull request on dbt Core or another repository, then link to
them here!

To learn more about the writing conventions used in the dbt Labs docs,
see the [Content style
guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md).
-->

## Checklist
- [x] I have reviewed the [Content style
guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md)
so my content adheres to these guidelines.
- [x] The topic I'm writing about is for specific dbt version(s) and I
have versioned it according to the [version a whole
page](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#adding-a-new-version)
and/or [version a block of
content](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-blocks-of-content)
guidelines.
- [ ] I have added checklist item(s) to this list for anything anything
that needs to happen before this PR is merged, such as "needs technical
review" or "change base branch."
<!--
PRE-RELEASE VERSION OF dbt (if so, uncomment):
- [ ] Add a note to the prerelease version [Migration
Guide](https://github.com/dbt-labs/docs.getdbt.com/tree/current/website/docs/docs/dbt-versions/core-upgrade)
-->
<!-- 
ADDING OR REMOVING PAGES (if so, uncomment):
- [ ] Add/remove page in `website/sidebars.js`
- [ ] Provide a unique filename for new pages
- [ ] Add an entry for deleted pages in `website/vercel.json`
- [ ] Run link testing locally with `npm run build` to update the links
that point to deleted pages
-->

---------

Co-authored-by: Matt Shaver <[email protected]>
Co-authored-by: Leona B. Campbell <[email protected]>
Co-authored-by: Doug Beatty <[email protected]>
  • Loading branch information
4 people authored Oct 1, 2024
1 parent b4ce442 commit b7c883c
Showing 1 changed file with 6 additions and 3 deletions.
9 changes: 6 additions & 3 deletions website/docs/docs/collaborate/govern/model-contracts.md
Original file line number Diff line number Diff line change
Expand Up @@ -206,9 +206,12 @@ At the same time, for models with many columns, we understand that this can mean
When comparing to a previous project state, dbt will look for breaking changes that could impact downstream consumers. If breaking changes are detected, dbt will present a contract error.

Breaking changes include:
- Removing an existing column
- Changing the `data_type` of an existing column
- Removing or modifying one of the `constraints` on an existing column (dbt v1.6 or higher)
- Removing an existing column.
- Changing the `data_type` of an existing column.
- Removing or modifying one of the `constraints` on an existing column (dbt v1.6 or higher).
- Removing a contracted model by deleting, renaming, or disabling it (dbt v1.9 or higher).
- versioned models will raise an error.
- unversioned models will raise a warning.

More details are available in the [contract reference](/reference/resource-configs/contract#detecting-breaking-changes).

0 comments on commit b7c883c

Please sign in to comment.