Skip to content

Conversation

koletzilla
Copy link
Contributor

@koletzilla koletzilla commented Oct 14, 2025

Summary

  • Improve explanation of concepts and differences between materializations.
  • Explain better table vs model configurations.
  • Move some configurations to specific materializations.

Copy link

vercel bot commented Oct 14, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
clickhouse-docs Error Error Comment Oct 14, 2025 6:02pm
clickhouse-docs-jp Building Building Preview Comment Oct 14, 2025 6:02pm
2 Skipped Deployments
Project Deployment Preview Comments Updated (UTC)
clickhouse-docs-ru Ignored Ignored Preview Oct 14, 2025 6:02pm
clickhouse-docs-zh Ignored Ignored Preview Oct 14, 2025 6:02pm

Comment on lines +148 to +149
| indexes | A list of [data skipping indexes](/optimize/skipping-indexes) to create. See [About data skipping indexes](#data-skipping-indexes) for details. | |
| sql_security | The ClickHouse user to use when executing the view's underlying query. [Accepted values](/sql-reference/statements/create/view#sql_security): `definer`, `invoker`. | |
Copy link
Contributor Author

Choose a reason for hiding this comment

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

@morsapaes sorry, I changed these lines with your suggestions in #4562 (review) and I didn't commit them 🤦

Comment on lines -134 to +136
### General table configurations {#general-table-configurations}
### General model configurations {#general-model-configurations}

The following table shows configurations shared by some of the available materializations. For in-depth information about general dbt model configurations, see the [dbt documentation](https://docs.getdbt.com/category/general-configs):
Copy link
Contributor Author

Choose a reason for hiding this comment

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

@morsapaes I have been doing some changes related to the reorganization of the settings per each materialization:

  • It has not been easy to redistribute the settings for each materialization as most of them are used by several materializations. The only only two that I could move have been unique_key and sharding_key
  • I have changed the title and the explanation to make it clear that these configs are shared by most of the materializations and that this is related to the model, not to a table.
  • Do you have any suggestion about possible structure improvements? I guess that at some point we can just move all configs to each of the materializations and just duplicate the setting explanation when needed. But thinking about it, I feel like it may complicate the reading/understanding of existing configurations.

What do you think?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant