From 4294a0bdeb3bc1d36505f3528e746f8e15ac2c6b Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Wed, 7 Dec 2022 13:35:14 -0500 Subject: [PATCH 01/19] Changes to docs due to 0.20/1 deprecation --- contributing/single-sourcing-content.md | 4 +- website/dbt-versions.js | 8 - website/docs/docs/build/incremental-models.md | 9 +- website/docs/docs/build/snapshots.md | 4 +- .../cloud-choosing-a-dbt-version.md | 7 +- .../docs/docs/dbt-versions/core-versions.md | 40 ++--- .../dbt-versions/upgrade-core-in-cloud.md | 7 +- website/docs/docs/deploy/source-freshness.md | 9 +- .../docs/get-started/connection-profiles.md | 4 +- .../faqs/Project/properties-not-in-config.md | 2 +- .../snapshotting-freshness-for-one-source.md | 1 - website/docs/faqs/Tests/testing-sources.md | 8 - .../docs/guides/legacy/understanding-state.md | 2 +- website/docs/reference/commands/build.md | 6 - website/docs/reference/commands/deps.md | 6 - website/docs/reference/commands/source.md | 12 -- .../docs/reference/configs-and-properties.md | 6 +- .../reference/dbt-jinja-functions/dispatch.md | 4 - .../reference/dbt-jinja-functions/env_var.md | 3 +- website/docs/reference/model-configs.md | 4 - website/docs/reference/model-properties.md | 4 - .../docs/reference/node-selection/defer.md | 21 +-- .../docs/reference/node-selection/exclude.md | 11 -- .../node-selection/graph-operators.md | 34 ---- .../docs/reference/node-selection/methods.md | 115 +------------- .../node-selection/putting-it-together.md | 25 --- .../reference/node-selection/set-operators.md | 39 ----- .../state-comparison-caveats.md | 6 +- .../docs/reference/node-selection/syntax.md | 37 ----- .../node-selection/test-selection-examples.md | 146 +----------------- .../node-selection/yaml-selectors.md | 20 +-- .../project-configs/dispatch-config.md | 2 +- .../resource-configs/column_types.md | 2 +- .../reference/resource-configs/fail_calc.md | 7 - .../docs/reference/resource-configs/limit.md | 7 - .../docs/reference/resource-configs/meta.md | 6 - .../resource-configs/persist_docs.md | 6 - .../resource-configs/quote_columns.md | 2 - website/docs/reference/seed-configs.md | 5 - website/docs/reference/seed-properties.md | 5 +- website/docs/reference/snapshot-properties.md | 4 - website/docs/reference/test-configs.md | 8 - website/snippets/core-versions-table.md | 3 +- 43 files changed, 44 insertions(+), 617 deletions(-) diff --git a/contributing/single-sourcing-content.md b/contributing/single-sourcing-content.md index 1c47b87b977..cf58c799999 100644 --- a/contributing/single-sourcing-content.md +++ b/contributing/single-sourcing-content.md @@ -90,7 +90,7 @@ This component can be added directly to a markdown file in a similar way as othe Both properties can be used together to set a range where the content should show. In the example below, this content will only show if the selected version is between **0.21** and **1.0**: ```markdown - + Versioned content here @@ -109,14 +109,12 @@ You see this block when the selected version is >= 0.21: ```markdown - ```shell $ dbt run --select [...] --defer --state path/to/artifacts $ dbt test --select [...] --defer --state path/to/artifacts \``` - ``` You see this version block when the selected version is <= 0.20 diff --git a/website/dbt-versions.js b/website/dbt-versions.js index 03f2721e42d..7000414bdfd 100644 --- a/website/dbt-versions.js +++ b/website/dbt-versions.js @@ -15,14 +15,6 @@ exports.versions = [ version: "1.0", EOLDate: "2022-12-03" }, - { - version: "0.21", - EOLDate: "2022-06-30" - }, - { - version: "0.20", - EOLDate: "2022-06-30" - } ] exports.versionedPages = [ diff --git a/website/docs/docs/build/incremental-models.md b/website/docs/docs/build/incremental-models.md index 08911764e32..c36431f7499 100644 --- a/website/docs/docs/build/incremental-models.md +++ b/website/docs/docs/build/incremental-models.md @@ -75,7 +75,7 @@ For more complex incremental models that make use of Common Table Expressions (C A `unique_key` determines whether a record has new values and should be updated. By using `unique_key`, you can ensure that each row from the source table is represented by a single row in your incremental model, without duplicates. Not specifying a `unique_key` will result in append-only behavior, which means dbt inserts all rows returned by the model's SQL into the preexisting target table without regard for whether the rows represent duplicates. - + This optional parameter for incremental models specifies a field that can uniquely identify each row within your model. You can define `unique_key` in a configuration block at the top of your model. If your model doesn't contain a single field that is unique, but rather a combination of columns, we recommend that you create a single column that can serve as unique identifier (by concatenating and hashing those columns), and pass it into your model's configuration. @@ -272,13 +272,6 @@ select ... ### Strategy-specific configs - - - - **v0.20.0:** Introduced `merge_update_columns` - - **v0.21.0:** Introduced `on_schema_change` - - - If you are using the `merge` strategy and have specified a `unique_key`, by default, dbt will entirely overwrite matched rows with new values. On adapters which support the `merge` strategy (including Snowflake, BigQuery, Apache Spark, and Databricks), you may optionally pass a list of column names to a `merge_update_columns` config. In that case, dbt will update _only_ the columns specified by the config, and keep the previous values of other columns. diff --git a/website/docs/docs/build/snapshots.md b/website/docs/docs/build/snapshots.md index a204c0416c5..3418d54c191 100644 --- a/website/docs/docs/build/snapshots.md +++ b/website/docs/docs/build/snapshots.md @@ -243,8 +243,6 @@ The `check` snapshot strategy can be configured to track changes to _all_ column ### Hard deletes (opt-in) -New in v0.19.0 - Rows that are deleted from the source query are not invalidated by default. With the config option `invalidate_hard_deletes`, dbt can track rows that no longer exist. This is done by left joining the snapshot table with the source table, and filtering the rows that are still valid at that point, but no longer can be found in the source table. `dbt_valid_to` will be set to the current snapshot time. This configuration is not a different strategy as described above, but is an additional opt-in feature. It is not enabled by default since it alters the previous behavior. @@ -294,7 +292,7 @@ A number of other configurations are also supported (e.g. `tags` and `post-hook` Snapshots can be configured from both your `dbt_project.yml` file and a `config` block, check out the [configuration docs](snapshot-configs) for more information. -Note: As of v0.21, BigQuery users can use `target_project` and `target_dataset` as aliases for `target_database` and `target_schema`, respectively. +Note: BigQuery users can use `target_project` and `target_dataset` as aliases for `target_database` and `target_schema`, respectively. ### Configuration best practices diff --git a/website/docs/docs/dbt-cloud/cloud-configuring-dbt-cloud/cloud-choosing-a-dbt-version.md b/website/docs/docs/dbt-cloud/cloud-configuring-dbt-cloud/cloud-choosing-a-dbt-version.md index c4a7e39d91c..2b8012d4b4d 100644 --- a/website/docs/docs/dbt-cloud/cloud-configuring-dbt-cloud/cloud-choosing-a-dbt-version.md +++ b/website/docs/docs/dbt-cloud/cloud-configuring-dbt-cloud/cloud-choosing-a-dbt-version.md @@ -32,12 +32,7 @@ We will continue to update this table so that customers know when we plan to sto - -:::warning ⚠️ v0.X Non-Supported Period - Accounts had until the end of June 2022 to upgrade to dbt 1.0 or later. Pre-dbt 1.0 versions will no longer receive patch fixes, and our support team will no longer assist with dbt version specific help on non-supported versions of dbt. Additionally, jobs running dbt versions prior to 1.0 may experience service disruptions before the end of the year and may be removed from the dbt Cloud context by year end. You will receive additional notification before any planned disruption to your production jobs. -::: - -Starting in v1.0, dbt Cloud will ensure that you're always using the latest compatible patch release of `dbt-core` and plugins, including all the latest fixes. You may also choose to try prereleases of those patch releases before they are generally available. +Starting with v1.0, dbt Cloud will ensure that you're always using the latest compatible patch release of `dbt-core` and plugins, including all the latest fixes. You may also choose to try prereleases of those patch releases before they are generally available.