Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge in the on_configuration_change config on relevant pages (#5940)
## What are you changing in this pull request and why? * I added the order in which materializations are run to the materialized.md reference page. It's important and helpful information. I do not know how to make sure the same snippet occurs on multiple doc pages in a DRY way. * I added `on_configuration_change` to the possible model configurations list. * I added links to the `on_configuration_change` page to other pages that may have an interaction with it. I did not: * Attempt to fully integrate `on_configuration_change` into the doc pages. I linked to it so it's at least on those pages. If you want to edit them more, they are easily gathered for you in this PR. I don't promise it's a complete list. Questions I think are relevant to include or clarify: 1. What counts as a configuration change? If it's only for materialized views, then you probably can't mean materialization type changes. 2. How does `on_configuration_change` interact with `--defer`? 3. When you say "model does not exist in the provided path, do you mean database structure or file structure? Does it understand `identifier` and `alias`? If it's database structure and the database object name already exists because it was added manually outside of dbt will it drop/delete that object even though it has no information about it(and hence can't know whether it's allowed to have the power to drop/delete it)? 4. When you say "when the model exists, but has a different type" do you mean materialization type? 5. "Determine whether to apply the configuration changes" is both vague and disconcerting. dbt could decide not to follow the `on_configuration_change` specified by the dbt AE? 6. How does this interact with `grants`? 7. I assume it has no interaction with pre-hooks, post-hooks, on-run-start, on-run-end, correct? 8. What's the error message and where is it displayed if you specify `on_configuration_change` and your adapter doesn't support it? Please go ahead and change it however you want as I'm unlikely to get back to this PR to make any changes myself in a timely manner. ## Checklist - [x] Review 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] For [docs versioning](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#about-versioning), review how to [version a whole page](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#adding-a-new-version) and [version a block of content](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-blocks-of-content). - [x] Add a checklist item for anything that needs to happen before this PR is merged, such as "needs technical review" or "change base branch." - [ ] May need technical review as is. Will need technical review if any of the questions posed have answers added in this PR. --------- Co-authored-by: Matt Shaver <[email protected]>
- Loading branch information