dbt-labs / dbt-labs/docs.getdbt.com

Explain how `on_schema_change` handles new or removed columns for an incremental model

Open
#2,902 1 comment 0 reactions 0 assignees View on GitHub
content improvement incremental models priority: medium size: x-small
Dominant language
JavaScript
Stars
215
Forks
1.2k
Avg merge
1d 15h
Merged PRs (30d)
130

Description

### Contributions

- [X] I have read the contribution docs, and understand what's expected of me.

### Link to the page on docs.getdbt.com requiring updates

https://docs.getdbt.com/docs/build/incremental-models#what-if-the-columns-of-my-incremental-model-change

### What part(s) of the page would you like to see updated?

@Fleid noted [here](https://github.com/dbt-labs/dbt-adapters/issues/601) that the following is a more complete and accurate description of how the value of `on_schema_change` behaves for incremental models when:
1. new columns are added, and
2. when columns are removed

|`on_schema_change`|In case of new columns...|In case of removed columns...|
|-|-|-|
|`ignore`|columns ignored|run failed|
|`fail`|run failed|run failed|
|`append_new_columns`|columns added|columns ignored|
|`sync_all_columns`|columns added|columns removed|

### Additional information

_No response_

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.