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 0209ea4b53e..6460c210958 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 @@ -93,5 +93,7 @@ We will begin deprecating support for spaces in dbt model names in v1.8 (raising - [Global config flags](/reference/global-configs/about-global-configs) are deprecated from the [`profiles.yml`](/docs/core/connect-data-platform/profiles.yml) file and should be moved to the [`dbt_project.yml`](/reference/dbt_project.yml). - A new subcategory of flags has been created for [legacy behaviors](/reference/global-configs/legacy-behaviors). - The [`--indirect_selection`](/reference/global-configs/indirect-selection) flag used with `dbt test` or `dbt build` configures which tests to run for the nodes you specify. +- New CLI flag [`--resource-type`/`--exclude-resource-type`](/reference/global-configs/resource-type) for including/excluding resources from dbt `build`, `run`, and `clone`. - To improve performance, dbt now issues a single (batch) query when calculating `source freshness` through metadata, instead of executing a query per source. + diff --git a/website/docs/reference/global-configs/about-global-configs.md b/website/docs/reference/global-configs/about-global-configs.md index b61c318866d..e2bc515894d 100644 --- a/website/docs/reference/global-configs/about-global-configs.md +++ b/website/docs/reference/global-configs/about-global-configs.md @@ -82,6 +82,7 @@ Because the values of `flags` can differ across invocations, we strongly advise | [profiles_dir](/docs/core/connect-data-platform/connection-profiles#about-profiles) | path | None (current dir, then HOME dir) | ❌ | `DBT_PROFILES_DIR` | `--profiles-dir` | ❌ | | [project_dir](/reference/dbt_project.yml) | path | | ❌ | `DBT_PROJECT_DIR` | `--project-dir` | ❌ | | [quiet](/reference/global-configs/logs#suppress-non-error-logs-in-output) | boolean | False | ❌ | `DBT_QUIET` | `--quiet` | ✅ | +| [resource-type](/reference/global-configs/resource-type) (v1.8+) | string | None | ❌ | `DBT_RESOURCE_TYPES`

`DBT_EXCLUDE_RESOURCE_TYPES` | `--resource-type`

`--exclude-resource-type` | ✅ | | [send_anonymous_usage_stats](/reference/global-configs/usage-stats) | boolean | True | ✅ | `DBT_SEND_ANONYMOUS_USAGE_STATS` | `--send-anonymous-usage-stats`, `--no-send-anonymous-usage-stats` | ❌ | | [source_freshness_run_project_hooks](/reference/global-configs/legacy-behaviors#source_freshness_run_project_hooks) | boolean | False | ✅ | ❌ | ❌ | ❌ | | [state](/reference/node-selection/defer) | path | none | ❌ | `DBT_STATE`, `DBT_DEFER_STATE` | `--state`, `--defer-state` | ❌ | diff --git a/website/docs/reference/global-configs/resource-type.md b/website/docs/reference/global-configs/resource-type.md new file mode 100644 index 00000000000..db7e47badbd --- /dev/null +++ b/website/docs/reference/global-configs/resource-type.md @@ -0,0 +1,16 @@ +--- +title: "Resource type" +id: "resource-type" +sidebar: "resource type" +--- + +The `--resource-type` and `--exclude-resource-type` flags include or exclude resource types (such as unit tests) from the `dbt run`, `dbt build`, and `dbt clone` commands. + + + +```text +$ dbt build --exclude-resource-type UNIT_TEST_NAME + +``` + + \ No newline at end of file diff --git a/website/sidebars.js b/website/sidebars.js index c85c70d4630..cfd53c90d32 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -980,6 +980,7 @@ const sidebarSettings = { "reference/global-configs/parsing", "reference/global-configs/print-output", "reference/global-configs/record-timing-info", + "reference/global-configs/resource-type", "reference/global-configs/usage-stats", "reference/global-configs/version-compatibility", "reference/global-configs/warnings",