From 57bfa1de1cf6a34895bd3dffa7f817fc87d930cf Mon Sep 17 00:00:00 2001 From: Mikko Sulonen <60921263+mikkosulonen@users.noreply.github.com> Date: Tue, 31 Oct 2023 16:25:55 +0200 Subject: [PATCH 1/2] Add note about Snowflake using Dynamic Tables instead of Materialized views --- website/docs/docs/build/materializations.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/website/docs/docs/build/materializations.md b/website/docs/docs/build/materializations.md index 79fe2e1b7c5..36f87f462f6 100644 --- a/website/docs/docs/build/materializations.md +++ b/website/docs/docs/build/materializations.md @@ -143,6 +143,8 @@ less configuration options available, see your database platform's docs for more * **Advice:** * Consider materialized views for use cases where incremental models are sufficient, but you would like the data platform to manage the incremental logic and refresh. +Note that `dbt-snowflake` does NOT support materialized views, but Dynamic Tables instead. See [Snowflake specific configurations.](/reference/resource-configs/snowflake-configs#dynamic-tables) + ## Python materializations Python models support two materializations: From 22be5e6fd09ed8ebcc89e337752bb8846e3be753 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 15:15:44 +0000 Subject: [PATCH 2/2] Update materializations.md --- website/docs/docs/build/materializations.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/website/docs/docs/build/materializations.md b/website/docs/docs/build/materializations.md index 36f87f462f6..8846f4bb0c5 100644 --- a/website/docs/docs/build/materializations.md +++ b/website/docs/docs/build/materializations.md @@ -69,8 +69,8 @@ When using the `view` materialization, your model is rebuilt as a view on each r * **Pros:** No additional data is stored, views on top of source data will always have the latest records in them. * **Cons:** Views that perform a significant transformation, or are stacked on top of other views, are slow to query. * **Advice:** - * Generally start with views for your models, and only change to another materialization when you're noticing performance problems. - * Views are best suited for models that do not do significant transformation, e.g. renaming, recasting columns. + * Generally start with views for your models, and only change to another materialization when you notice performance problems. + * Views are best suited for models that do not do significant transformation, e.g. renaming, or recasting columns. ### Table When using the `table` materialization, your model is rebuilt as a on each run, via a `create table as` statement. @@ -135,7 +135,7 @@ Materialized views are a combination of a view and a table, and serve use cases * Materialized views operate much like incremental materializations, however they are usually able to be refreshed without manual interference on a regular cadence (depending on the database), forgoing the regular dbt batch refresh required with incremental materializations - * `dbt run` on materialized views correspond to a code deployment, just like views + * `dbt run` on materialized views corresponds to a code deployment, just like views * **Cons:** * Due to the fact that materialized views are more complex database objects, database platforms tend to have less configuration options available, see your database platform's docs for more details @@ -143,7 +143,7 @@ less configuration options available, see your database platform's docs for more * **Advice:** * Consider materialized views for use cases where incremental models are sufficient, but you would like the data platform to manage the incremental logic and refresh. -Note that `dbt-snowflake` does NOT support materialized views, but Dynamic Tables instead. See [Snowflake specific configurations.](/reference/resource-configs/snowflake-configs#dynamic-tables) +**Note:** `dbt-snowflake` _does not_ support materialized views, it uses Dynamic Tables instead. For details, refer to [Snowflake specific configurations](/reference/resource-configs/snowflake-configs#dynamic-tables). ## Python materializations