From fdd547ad254e62d91d1e44080be5fc906129d12a Mon Sep 17 00:00:00 2001 From: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> Date: Wed, 13 Dec 2023 19:42:18 -0700 Subject: [PATCH 1/3] Split the supported strategies from the default strategies --- website/docs/docs/build/incremental-models.md | 52 ++++++++++++------- 1 file changed, 32 insertions(+), 20 deletions(-) diff --git a/website/docs/docs/build/incremental-models.md b/website/docs/docs/build/incremental-models.md index 01a392c12fe..735caa3ffa5 100644 --- a/website/docs/docs/build/incremental-models.md +++ b/website/docs/docs/build/incremental-models.md @@ -247,36 +247,48 @@ Click the name of the adapter in the below table for more information about supp The `merge` strategy is available in dbt-postgres and dbt-redshift beginning in dbt v1.6. +Standard strategies available per adapter: + - -| data platform adapter | default strategy | additional supported strategies | -| :-------------------| ---------------- | -------------------- | -| [dbt-postgres](/reference/resource-configs/postgres-configs#incremental-materialization-strategies) | `append` | `delete+insert` | -| [dbt-redshift](/reference/resource-configs/redshift-configs#incremental-materialization-strategies) | `append` | `delete+insert` | -| [dbt-bigquery](/reference/resource-configs/bigquery-configs#merge-behavior-incremental-models) | `merge` | `insert_overwrite` | -| [dbt-spark](/reference/resource-configs/spark-configs#incremental-models) | `append` | `merge`, `insert_overwrite` | -| [dbt-databricks](/reference/resource-configs/databricks-configs#incremental-models) | `merge` | `append`, `insert_overwrite` | -| [dbt-snowflake](/reference/resource-configs/snowflake-configs#merge-behavior-incremental-models) | `merge` | `append`, `delete+insert` | -| [dbt-trino](/reference/resource-configs/trino-configs#incremental) | `append` | `merge`, `delete+insert` | +| data platform adapter | `append` | `merge` | `delete+insert` | `insert_overwrite` | +|-----------------------------------------------------------------------------------------------------|:--------:|:-------:|:---------------:|:------------------:| +| [dbt-postgres](/reference/resource-configs/postgres-configs#incremental-materialization-strategies) | ✔️ | | ✔️ | | +| [dbt-redshift](/reference/resource-configs/redshift-configs#incremental-materialization-strategies) | ✔️ | | ✔️ | | +| [dbt-bigquery](/reference/resource-configs/bigquery-configs#merge-behavior-incremental-models) | | ✔️ | | ✔️ | +| [dbt-spark](/reference/resource-configs/spark-configs#incremental-models) | ✔️ | ✔️ | | ✔️ | +| [dbt-databricks](/reference/resource-configs/databricks-configs#incremental-models) | ✔️ | ✔️ | | ✔️ | +| [dbt-snowflake](/reference/resource-configs/snowflake-configs#merge-behavior-incremental-models) | ✔️ | ✔️ | ✔️ | | +| [dbt-trino](/reference/resource-configs/trino-configs#incremental) | ✔️ | ✔️ | ✔️ | | - -| data platform adapter | default strategy | additional supported strategies | -| :----------------- | :----------------| : ---------------------------------- | -| [dbt-postgres](/reference/resource-configs/postgres-configs#incremental-materialization-strategies) | `append` | `merge` , `delete+insert` | -| [dbt-redshift](/reference/resource-configs/redshift-configs#incremental-materialization-strategies) | `append` | `merge`, `delete+insert` | -| [dbt-bigquery](/reference/resource-configs/bigquery-configs#merge-behavior-incremental-models) | `merge` | `insert_overwrite` | -| [dbt-spark](/reference/resource-configs/spark-configs#incremental-models) | `append` | `merge`, `insert_overwrite` | -| [dbt-databricks](/reference/resource-configs/databricks-configs#incremental-models) | `merge` | `append`, `insert_overwrite` | -| [dbt-snowflake](/reference/resource-configs/snowflake-configs#merge-behavior-incremental-models) | `merge` | `append`, `delete+insert` | -| [dbt-trino](/reference/resource-configs/trino-configs#incremental) | `append` | `merge`, `delete+insert` | +| data platform adapter | `append` | `merge` | `delete+insert` | `insert_overwrite` | +|-----------------------------------------------------------------------------------------------------|:--------:|:-------:|:---------------:|:------------------:| +| [dbt-postgres](/reference/resource-configs/postgres-configs#incremental-materialization-strategies) | ✔️ | ✔️ | ✔️ | | +| [dbt-redshift](/reference/resource-configs/redshift-configs#incremental-materialization-strategies) | ✔️ | ✔️ | ✔️ | | +| [dbt-bigquery](/reference/resource-configs/bigquery-configs#merge-behavior-incremental-models) | | ✔️ | | ✔️ | +| [dbt-spark](/reference/resource-configs/spark-configs#incremental-models) | ✔️ | ✔️ | | ✔️ | +| [dbt-databricks](/reference/resource-configs/databricks-configs#incremental-models) | ✔️ | ✔️ | | ✔️ | +| [dbt-snowflake](/reference/resource-configs/snowflake-configs#merge-behavior-incremental-models) | ✔️ | ✔️ | ✔️ | | +| [dbt-trino](/reference/resource-configs/trino-configs#incremental) | ✔️ | ✔️ | ✔️ | | +Default strategy per adapter: + +| data platform adapter | default strategy | +| :----------------- | :----------------| +| [dbt-postgres](/reference/resource-configs/postgres-configs#incremental-materialization-strategies) | `append` | +| [dbt-redshift](/reference/resource-configs/redshift-configs#incremental-materialization-strategies) | `append` | +| [dbt-bigquery](/reference/resource-configs/bigquery-configs#merge-behavior-incremental-models) | `merge` | +| [dbt-spark](/reference/resource-configs/spark-configs#incremental-models) | `append` | +| [dbt-databricks](/reference/resource-configs/databricks-configs#incremental-models) | `merge` | +| [dbt-snowflake](/reference/resource-configs/snowflake-configs#merge-behavior-incremental-models) | `merge` | +| [dbt-trino](/reference/resource-configs/trino-configs#incremental) | `append` | + :::note Snowflake Configurations From c07d4421048297fbabfb477eacfbe9a5136ce0fb Mon Sep 17 00:00:00 2001 From: Doug Beatty <44704949+dbeatty10@users.noreply.github.com> Date: Wed, 13 Dec 2023 20:31:57 -0700 Subject: [PATCH 2/3] Defer the default strategy information to each adapter-specific config page --- website/docs/docs/build/incremental-models.md | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/website/docs/docs/build/incremental-models.md b/website/docs/docs/build/incremental-models.md index 735caa3ffa5..de1b69bf9df 100644 --- a/website/docs/docs/build/incremental-models.md +++ b/website/docs/docs/build/incremental-models.md @@ -247,8 +247,6 @@ Click the name of the adapter in the below table for more information about supp The `merge` strategy is available in dbt-postgres and dbt-redshift beginning in dbt v1.6. -Standard strategies available per adapter: - | data platform adapter | `append` | `merge` | `delete+insert` | `insert_overwrite` | @@ -277,18 +275,6 @@ Standard strategies available per adapter: -Default strategy per adapter: - -| data platform adapter | default strategy | -| :----------------- | :----------------| -| [dbt-postgres](/reference/resource-configs/postgres-configs#incremental-materialization-strategies) | `append` | -| [dbt-redshift](/reference/resource-configs/redshift-configs#incremental-materialization-strategies) | `append` | -| [dbt-bigquery](/reference/resource-configs/bigquery-configs#merge-behavior-incremental-models) | `merge` | -| [dbt-spark](/reference/resource-configs/spark-configs#incremental-models) | `append` | -| [dbt-databricks](/reference/resource-configs/databricks-configs#incremental-models) | `merge` | -| [dbt-snowflake](/reference/resource-configs/snowflake-configs#merge-behavior-incremental-models) | `merge` | -| [dbt-trino](/reference/resource-configs/trino-configs#incremental) | `append` | - :::note Snowflake Configurations From 29b9c8a0bce5bf9f0f02a2d8c1a9ea3a47f5ca36 Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Thu, 14 Dec 2023 14:57:08 -0500 Subject: [PATCH 3/3] Update incremental-models.md --- website/docs/docs/build/incremental-models.md | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/website/docs/docs/build/incremental-models.md b/website/docs/docs/build/incremental-models.md index de1b69bf9df..46788758ee6 100644 --- a/website/docs/docs/build/incremental-models.md +++ b/website/docs/docs/build/incremental-models.md @@ -251,13 +251,13 @@ The `merge` strategy is available in dbt-postgres and dbt-redshift beginning in | data platform adapter | `append` | `merge` | `delete+insert` | `insert_overwrite` | |-----------------------------------------------------------------------------------------------------|:--------:|:-------:|:---------------:|:------------------:| -| [dbt-postgres](/reference/resource-configs/postgres-configs#incremental-materialization-strategies) | ✔️ | | ✔️ | | -| [dbt-redshift](/reference/resource-configs/redshift-configs#incremental-materialization-strategies) | ✔️ | | ✔️ | | -| [dbt-bigquery](/reference/resource-configs/bigquery-configs#merge-behavior-incremental-models) | | ✔️ | | ✔️ | -| [dbt-spark](/reference/resource-configs/spark-configs#incremental-models) | ✔️ | ✔️ | | ✔️ | -| [dbt-databricks](/reference/resource-configs/databricks-configs#incremental-models) | ✔️ | ✔️ | | ✔️ | -| [dbt-snowflake](/reference/resource-configs/snowflake-configs#merge-behavior-incremental-models) | ✔️ | ✔️ | ✔️ | | -| [dbt-trino](/reference/resource-configs/trino-configs#incremental) | ✔️ | ✔️ | ✔️ | | +| [dbt-postgres](/reference/resource-configs/postgres-configs#incremental-materialization-strategies) | ✅ | | ✅ | | +| [dbt-redshift](/reference/resource-configs/redshift-configs#incremental-materialization-strategies) | ✅ | | ✅ | | +| [dbt-bigquery](/reference/resource-configs/bigquery-configs#merge-behavior-incremental-models) | | ✅ | | ✅ | +| [dbt-spark](/reference/resource-configs/spark-configs#incremental-models) | ✅ | ✅ | | ✅ | +| [dbt-databricks](/reference/resource-configs/databricks-configs#incremental-models) | ✅ | ✅ | | ✅ | +| [dbt-snowflake](/reference/resource-configs/snowflake-configs#merge-behavior-incremental-models) | ✅ | ✅ | ✅ | | +| [dbt-trino](/reference/resource-configs/trino-configs#incremental) | ✅ | ✅ | ✅ | | @@ -265,13 +265,13 @@ The `merge` strategy is available in dbt-postgres and dbt-redshift beginning in | data platform adapter | `append` | `merge` | `delete+insert` | `insert_overwrite` | |-----------------------------------------------------------------------------------------------------|:--------:|:-------:|:---------------:|:------------------:| -| [dbt-postgres](/reference/resource-configs/postgres-configs#incremental-materialization-strategies) | ✔️ | ✔️ | ✔️ | | -| [dbt-redshift](/reference/resource-configs/redshift-configs#incremental-materialization-strategies) | ✔️ | ✔️ | ✔️ | | -| [dbt-bigquery](/reference/resource-configs/bigquery-configs#merge-behavior-incremental-models) | | ✔️ | | ✔️ | -| [dbt-spark](/reference/resource-configs/spark-configs#incremental-models) | ✔️ | ✔️ | | ✔️ | -| [dbt-databricks](/reference/resource-configs/databricks-configs#incremental-models) | ✔️ | ✔️ | | ✔️ | -| [dbt-snowflake](/reference/resource-configs/snowflake-configs#merge-behavior-incremental-models) | ✔️ | ✔️ | ✔️ | | -| [dbt-trino](/reference/resource-configs/trino-configs#incremental) | ✔️ | ✔️ | ✔️ | | +| [dbt-postgres](/reference/resource-configs/postgres-configs#incremental-materialization-strategies) | ✅ | ✅ | ✅ | | +| [dbt-redshift](/reference/resource-configs/redshift-configs#incremental-materialization-strategies) | ✅ | ✅ | ✅ | | +| [dbt-bigquery](/reference/resource-configs/bigquery-configs#merge-behavior-incremental-models) | | ✅ | | ✅ | +| [dbt-spark](/reference/resource-configs/spark-configs#incremental-models) | ✅ | ✅ | | ✅ | +| [dbt-databricks](/reference/resource-configs/databricks-configs#incremental-models) | ✅ | ✅ | | ✅ | +| [dbt-snowflake](/reference/resource-configs/snowflake-configs#merge-behavior-incremental-models) | ✅ | ✅ | ✅ | | +| [dbt-trino](/reference/resource-configs/trino-configs#incremental) | ✅ | ✅ | ✅ | |