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

[Core] Caveat for SQL changes within a `materialized_view` model

Open
#5,215 0 comments 3 reactions 0 assignees View on GitHub
content dbt Core
Dominant language
JavaScript
Stars
215
Forks
1.2k
Avg merge
1d 15h
Merged PRs (30d)
130

Description

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

A couple potential places:
- https://docs.getdbt.com/reference/resource-configs/on_configuration_change
- https://docs.getdbt.com/docs/build/materializations#configuration-change-monitoring

### Tell us more about this update

Here's a common caveat we've seen that is applicable to materialized views (MVs):

Many people have been surprised that when they alter the SQL for a materialized view, that it does not trigger an update, refresh, or anything else.

Rather, it silently skips to the next model. That's because the SQL is not monitored and our implementation doesn't consider it a configuration change.

https://github.com/dbt-labs/dbt-core/issues/8862 was opened by a user that didn't expect this behavior.

### Reviewers/Stakeholders/SMEs

Adapters Team

### Related GitHub issues

- https://github.com/dbt-labs/dbt-core/issues/8862
- https://github.com/dbt-labs/docs.getdbt.com/pull/5213

### 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.