From 875f6eb1a14854dda9977cac6f152ca70fbfbe51 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Fri, 10 Nov 2023 10:51:10 +0000 Subject: [PATCH 1/2] clarify dbt rules for defer --- .../docs/docs/cloud/about-cloud-develop-defer.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/website/docs/docs/cloud/about-cloud-develop-defer.md b/website/docs/docs/cloud/about-cloud-develop-defer.md index 95e745fe963..48c4388578c 100644 --- a/website/docs/docs/cloud/about-cloud-develop-defer.md +++ b/website/docs/docs/cloud/about-cloud-develop-defer.md @@ -7,9 +7,20 @@ pagination_next: "docs/cloud/cloud-cli-installation" --- -[Defer](/reference/node-selection/defer) is a powerful feature that allows developers to only build and run and test models they've edited without having to first run and build all the models that come before them (upstream parents). This is powered by using a production manifest for comparison, and dbt will resolve the `{{ ref() }}` function with upstream production artifacts. +[Defer](/reference/node-selection/defer) is a powerful feature that allows developers to only build and run and test models they've edited without having to first run and build all the models that come before them (upstream parents). This is powered by using a production manifest for comparison, and dbt will resolve the `{{ ref() }}` function with upstream production artifacts. -Both the dbt Cloud IDE and the dbt Cloud CLI allow users to natively defer to production metadata directly in their development workflows, dramatically reducing development time and warehouse spend by preventing unnecessary model builds. +By default, dbt follows these rules: + +- Defers to the production environment when there's no development schema. +- If a development schema exists, dbt will prioritize those changes, which minimizes development time and avoids unnecessary model builds. + +Both the dbt Cloud IDE and the dbt Cloud CLI allow users to natively defer to production metadata directly in their development workflows. + +For specific scenarios: +- Use [`--favor-state`](/reference/node-selection/defer#favor-state) to always use production artifacts to resolve the ref. +- If facing issues with outdated tables in the dev schema, `--favor-state` is an alternative to defer. + +For a clean slate, it's a good practice to drop the dev schema at the start and end of your development cycle. ## Required setup From 1da1108401184321e93f7614e4baf6019803eb66 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Fri, 10 Nov 2023 10:51:40 +0000 Subject: [PATCH 2/2] consistency --- website/docs/docs/cloud/about-cloud-develop-defer.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/website/docs/docs/cloud/about-cloud-develop-defer.md b/website/docs/docs/cloud/about-cloud-develop-defer.md index 48c4388578c..1861a6d8a79 100644 --- a/website/docs/docs/cloud/about-cloud-develop-defer.md +++ b/website/docs/docs/cloud/about-cloud-develop-defer.md @@ -18,9 +18,9 @@ Both the dbt Cloud IDE and the dbt Cloud CLI allow users to natively defer to pr For specific scenarios: - Use [`--favor-state`](/reference/node-selection/defer#favor-state) to always use production artifacts to resolve the ref. -- If facing issues with outdated tables in the dev schema, `--favor-state` is an alternative to defer. +- If facing issues with outdated tables in the development schema, `--favor-state` is an alternative to defer. -For a clean slate, it's a good practice to drop the dev schema at the start and end of your development cycle. +For a clean slate, it's a good practice to drop the development schema at the start and end of your development cycle. ## Required setup