From 31a8cb447ba06a144c5277179cecf0050d9866a1 Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Wed, 21 Feb 2024 10:39:26 -0500 Subject: [PATCH 1/4] The empty flag --- website/docs/reference/commands/build.md | 8 ++++++++ website/docs/reference/commands/run.md | 8 ++++++++ 2 files changed, 16 insertions(+) diff --git a/website/docs/reference/commands/build.md b/website/docs/reference/commands/build.md index 846810c1652..8a82c87f988 100644 --- a/website/docs/reference/commands/build.md +++ b/website/docs/reference/commands/build.md @@ -25,6 +25,14 @@ In DAG order, for selected resources or an entire project. **Flags:** The `build` task supports all the same flags as `run`, `test`, `snapshot`, and `seed`. For flags that are shared between multiple tasks (e.g. `--full-refresh`), `build` will use the same value for all selected resource types (e.g. both models and seeds will be full refreshed). + + +### The `--empty` flag + +The `build` command supports the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will build the project and models, parse the files to identify changes, but won't actually execute the SQL against the target data warehouse. This ensures your models will build properly and validates dependencies. + + + ### Examples ``` diff --git a/website/docs/reference/commands/run.md b/website/docs/reference/commands/run.md index 557d0d71338..27112fb19f9 100644 --- a/website/docs/reference/commands/run.md +++ b/website/docs/reference/commands/run.md @@ -80,3 +80,11 @@ See [global configs](/reference/global-configs/failing-fast) ## Enable or Disable Colorized Logs See [global configs](/reference/global-configs/print-output#print-color) + + + +## The `--empty` flag + +The `run` command supports the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will build the project and models, parse the files to identify changes, but won't actually execute the SQL against the target data warehouse. This ensures your models will build properly and validates dependencies. + + \ No newline at end of file From 89f6e054c4fcd9f6d71f78fb5b052eff986b212a Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Wed, 21 Feb 2024 10:46:44 -0500 Subject: [PATCH 2/4] Adding migration guide info --- .../docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md index 2dcc17e4ee9..1c1cdb34005 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md +++ b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md @@ -28,7 +28,12 @@ dbt Labs is committed to providing backward compatibility for all versions 1.x, ## New and changed features and functionality -Coming soon! +Features and functionality new in dbt v1.8 + +### The `--empty` flag + +The [`run`](/reference/commands/run#the-`--empty`-flag) and [`build`](/reference/commands/run#the-`--empty`-flag) commands now support the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will build the project and models, parse the files to identify changes, but won't actually execute the SQL against the target data warehouse. This ensures your models will build properly and validates dependencies. + ## Quick hits From d409f9552ba77e67ea53f151f5825f59fd65d450 Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Mon, 26 Feb 2024 10:49:39 -0500 Subject: [PATCH 3/4] Apply suggestions from code review --- .../docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md | 2 +- website/docs/reference/commands/build.md | 2 +- website/docs/reference/commands/run.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md index 1c1cdb34005..c31ff493721 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md +++ b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md @@ -32,7 +32,7 @@ Features and functionality new in dbt v1.8 ### The `--empty` flag -The [`run`](/reference/commands/run#the-`--empty`-flag) and [`build`](/reference/commands/run#the-`--empty`-flag) commands now support the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will build the project and models, parse the files to identify changes, but won't actually execute the SQL against the target data warehouse. This ensures your models will build properly and validates dependencies. +The [`run`](/reference/commands/run#the-`--empty`-flag) and [`build`](/reference/commands/run#the-`--empty`-flag) commands now support the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will still execute the model SQL against the target data warehouse but will avoid expensive reads of input data. This validates dependencies and ensures your models will build properly. ## Quick hits diff --git a/website/docs/reference/commands/build.md b/website/docs/reference/commands/build.md index 8a82c87f988..c83f669fe26 100644 --- a/website/docs/reference/commands/build.md +++ b/website/docs/reference/commands/build.md @@ -29,7 +29,7 @@ In DAG order, for selected resources or an entire project. ### The `--empty` flag -The `build` command supports the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will build the project and models, parse the files to identify changes, but won't actually execute the SQL against the target data warehouse. This ensures your models will build properly and validates dependencies. +The `build` command supports the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will still execute the model SQL against the target data warehouse but will avoid expensive reads of input data. This validates dependencies and ensures your models will build properly. diff --git a/website/docs/reference/commands/run.md b/website/docs/reference/commands/run.md index 27112fb19f9..609503e62dd 100644 --- a/website/docs/reference/commands/run.md +++ b/website/docs/reference/commands/run.md @@ -85,6 +85,6 @@ See [global configs](/reference/global-configs/print-output#print-color) ## The `--empty` flag -The `run` command supports the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will build the project and models, parse the files to identify changes, but won't actually execute the SQL against the target data warehouse. This ensures your models will build properly and validates dependencies. +The `run` command supports the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will still execute the model SQL against the target data warehouse but will avoid expensive reads of input data. This validates dependencies and ensures your models will build properly. \ No newline at end of file From e644caaf6daba7bcea48e96eb83dca94182b80d6 Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Mon, 26 Feb 2024 11:17:13 -0500 Subject: [PATCH 4/4] Update website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md Co-authored-by: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> --- .../docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md index c31ff493721..ec33e40b5b1 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md +++ b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.8.md @@ -32,7 +32,7 @@ Features and functionality new in dbt v1.8 ### The `--empty` flag -The [`run`](/reference/commands/run#the-`--empty`-flag) and [`build`](/reference/commands/run#the-`--empty`-flag) commands now support the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will still execute the model SQL against the target data warehouse but will avoid expensive reads of input data. This validates dependencies and ensures your models will build properly. +The [`run`](/reference/commands/run#the-`--empty`-flag) and [`build`](/reference/commands/build#the---empty-flag) commands now support the `--empty` flag for building schema-only dry runs. The `--empty` flag limits the refs and sources to zero rows. dbt will still execute the model SQL against the target data warehouse but will avoid expensive reads of input data. This validates dependencies and ensures your models will build properly. ## Quick hits