From 32396db40d42ac7d281ec1def3fd7558e4383f46 Mon Sep 17 00:00:00 2001 From: Agnes Kiss Date: Thu, 17 Aug 2023 15:49:21 +0100 Subject: [PATCH 01/59] Add more warehouses to database permissions --- .../docs/faqs/Warehouse/database-privileges.md | 4 ++-- .../databricks-permissions.md | 17 +++++++++++++++++ .../postgres-permissions.md | 18 ++++++++++++++++++ .../redshift-permissions.md | 18 ++++++++++++++++++ .../snowflake-permissions.md | 0 website/docs/reference/references-overview.md | 18 ++++++++++++++++++ website/sidebars.js | 7 ++++++- 7 files changed, 79 insertions(+), 3 deletions(-) create mode 100644 website/docs/reference/database-permissions/databricks-permissions.md create mode 100644 website/docs/reference/database-permissions/postgres-permissions.md create mode 100644 website/docs/reference/database-permissions/redshift-permissions.md rename website/docs/reference/{ => database-permissions}/snowflake-permissions.md (100%) diff --git a/website/docs/faqs/Warehouse/database-privileges.md b/website/docs/faqs/Warehouse/database-privileges.md index 73e0549f130..692b67f4e0a 100644 --- a/website/docs/faqs/Warehouse/database-privileges.md +++ b/website/docs/faqs/Warehouse/database-privileges.md @@ -12,8 +12,8 @@ schema¹ * read system views to generate documentation (i.e. views in `information_schema`) -On Postgres, Redshift, and Snowflake, use a series of `grants` to ensure that -your user has the correct privileges. +On Postgres, Redshift, Databricks, and Snowflake, use a series of `grants` to ensure that +your user has the correct privileges. Check out [example permissions](/reference/database-permissions/snowflake-permissions) for these warehouses. On BigQuery, use the "BigQuery User" role to assign these privileges. diff --git a/website/docs/reference/database-permissions/databricks-permissions.md b/website/docs/reference/database-permissions/databricks-permissions.md new file mode 100644 index 00000000000..14b24355d8a --- /dev/null +++ b/website/docs/reference/database-permissions/databricks-permissions.md @@ -0,0 +1,17 @@ +--- +title: "Databricks Permissions" +--- + +## Example Databricks permissions + +``` +-- NOTE: in general permissions can be granted on securable_objects to +principals (can be user, service principal, or group) +-- e.g.: grant privilege_type on securable_object to principal + +grant all privileges on schema schema_name to principal; +grant create table on schema schema_name to principal; +grant create view on schema schema_name to principal; +``` + +Check out the [Official Documentation](https://docs.databricks.com/en/data-governance/unity-catalog/manage-privileges/privileges.html#privilege-types-by-securable-object-in-unity-catalog) for more information. diff --git a/website/docs/reference/database-permissions/postgres-permissions.md b/website/docs/reference/database-permissions/postgres-permissions.md new file mode 100644 index 00000000000..bbab2fe5f4f --- /dev/null +++ b/website/docs/reference/database-permissions/postgres-permissions.md @@ -0,0 +1,18 @@ +--- +title: "Postgres Permissions" +--- + +## Example Postgres permissions + +``` +grant usage on database database_name to user_name; +grant create schema on database database_name to user_name; +grant usage on schema database.schema_name to user_name; +grant create table on schema database.schema_name to user_name; +grant create view on schema database.schema_name to user_name; +grant usage on all schemas in database database_name to user_name; +grant select on all tables in database database_name to user_name; +grant select on all views in database database_name to user_name; +``` + +Check out the [Official Documentation](https://www.postgresql.org/docs/current/sql-grant.html) for more information. diff --git a/website/docs/reference/database-permissions/redshift-permissions.md b/website/docs/reference/database-permissions/redshift-permissions.md new file mode 100644 index 00000000000..4c8dc59d723 --- /dev/null +++ b/website/docs/reference/database-permissions/redshift-permissions.md @@ -0,0 +1,18 @@ +--- +title: "Redshift Permissions" +--- + +## Example Redshift permissions + +``` +grant usage on database database_name to user_name; +grant create schema on database database_name to user_name; +grant usage on schema database.schema_name to user_name; +grant create table on schema database.schema_name to user_name; +grant create view on schema database.schema_name to user_name; +grant usage on all schemas in database database_name to user_name; +grant select on all tables in database database_name to user_name; +grant select on all views in database database_name to user_name; +``` + +Check out the [Official Documentation](https://docs.aws.amazon.com/redshift/latest/dg/r_GRANT.html) for more information. diff --git a/website/docs/reference/snowflake-permissions.md b/website/docs/reference/database-permissions/snowflake-permissions.md similarity index 100% rename from website/docs/reference/snowflake-permissions.md rename to website/docs/reference/database-permissions/snowflake-permissions.md diff --git a/website/docs/reference/references-overview.md b/website/docs/reference/references-overview.md index 16afd01607c..263d0f606ec 100644 --- a/website/docs/reference/references-overview.md +++ b/website/docs/reference/references-overview.md @@ -54,4 +54,22 @@ Learn how to add more configurations to your dbt project or adapter, use propert link="/reference/snowflake-permissions" icon="computer"/> + + + + + + diff --git a/website/sidebars.js b/website/sidebars.js index e319f4d49bf..5a527e1a06c 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -871,7 +871,12 @@ const sidebarSettings = { { type: "category", label: "Database Permissions", - items: ["reference/snowflake-permissions"], + items: [ + "reference/database-permissions/snowflake-permissions", + "reference/database-permissions/databricks-permissions", + "reference/database-permissions/redshift-permissions", + "reference/database-permissions/postgres-permissions", + ], }, ], guides: [ From 081512e0461453c089426b25a9cbdb6943774617 Mon Sep 17 00:00:00 2001 From: Agnes Kiss Date: Thu, 17 Aug 2023 16:53:18 +0100 Subject: [PATCH 02/59] Fix broken links --- .../docs/cloud/connect-data-platform/connect-snowflake.md | 2 +- website/docs/reference/references-overview.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/website/docs/docs/cloud/connect-data-platform/connect-snowflake.md b/website/docs/docs/cloud/connect-data-platform/connect-snowflake.md index 4f31c56e8aa..6cff28ae584 100644 --- a/website/docs/docs/cloud/connect-data-platform/connect-snowflake.md +++ b/website/docs/docs/cloud/connect-data-platform/connect-snowflake.md @@ -15,7 +15,7 @@ The following fields are required when creating a Snowflake connection | Warehouse | The virtual warehouse to use for running queries. | `transforming` | -**Note:** A crucial part of working with dbt atop Snowflake is ensuring that users (in development environments) and/or service accounts (in deployment to production environments) have the correct permissions to take actions on Snowflake! Here is documentation of some [example permissions to configure Snowflake access](/reference/snowflake-permissions). +**Note:** A crucial part of working with dbt atop Snowflake is ensuring that users (in development environments) and/or service accounts (in deployment to production environments) have the correct permissions to take actions on Snowflake! Here is documentation of some [example permissions to configure Snowflake access](/reference/database-permissions/snowflake-permissions). ### Username / Password diff --git a/website/docs/reference/references-overview.md b/website/docs/reference/references-overview.md index 263d0f606ec..37d80104277 100644 --- a/website/docs/reference/references-overview.md +++ b/website/docs/reference/references-overview.md @@ -51,25 +51,25 @@ Learn how to add more configurations to your dbt project or adapter, use propert From d0c8aaf4d84ce7efc3f0eb6d9cef980427202151 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Mon, 25 Sep 2023 15:44:07 +0100 Subject: [PATCH 03/59] Update website/docs/reference/database-permissions/databricks-permissions.md --- .../reference/database-permissions/databricks-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/databricks-permissions.md b/website/docs/reference/database-permissions/databricks-permissions.md index 14b24355d8a..5bfe1c9252a 100644 --- a/website/docs/reference/database-permissions/databricks-permissions.md +++ b/website/docs/reference/database-permissions/databricks-permissions.md @@ -14,4 +14,4 @@ grant create table on schema schema_name to principal; grant create view on schema schema_name to principal; ``` -Check out the [Official Documentation](https://docs.databricks.com/en/data-governance/unity-catalog/manage-privileges/privileges.html#privilege-types-by-securable-object-in-unity-catalog) for more information. +Check out the [official documentation](https://docs.databricks.com/en/data-governance/unity-catalog/manage-privileges/privileges.html#privilege-types-by-securable-object-in-unity-catalog) for more information. From 2fd5835cf8a7aaf7ed87cdb416528dd23ba71ef8 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Mon, 25 Sep 2023 15:54:10 +0100 Subject: [PATCH 04/59] Update website/docs/reference/database-permissions/redshift-permissions.md --- .../docs/reference/database-permissions/redshift-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/redshift-permissions.md b/website/docs/reference/database-permissions/redshift-permissions.md index 4c8dc59d723..f173e2584d4 100644 --- a/website/docs/reference/database-permissions/redshift-permissions.md +++ b/website/docs/reference/database-permissions/redshift-permissions.md @@ -15,4 +15,4 @@ grant select on all tables in database database_name to user_name; grant select on all views in database database_name to user_name; ``` -Check out the [Official Documentation](https://docs.aws.amazon.com/redshift/latest/dg/r_GRANT.html) for more information. +Check out the [official documentation](https://docs.aws.amazon.com/redshift/latest/dg/r_GRANT.html) for more information. From 92392ff7d587ab2eabae138787552ec0673b0770 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Mon, 25 Sep 2023 15:54:32 +0100 Subject: [PATCH 05/59] Update website/docs/reference/database-permissions/postgres-permissions.md --- .../docs/reference/database-permissions/postgres-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/postgres-permissions.md b/website/docs/reference/database-permissions/postgres-permissions.md index bbab2fe5f4f..24bb91317cc 100644 --- a/website/docs/reference/database-permissions/postgres-permissions.md +++ b/website/docs/reference/database-permissions/postgres-permissions.md @@ -15,4 +15,4 @@ grant select on all tables in database database_name to user_name; grant select on all views in database database_name to user_name; ``` -Check out the [Official Documentation](https://www.postgresql.org/docs/current/sql-grant.html) for more information. +Check out the [official documentation](https://www.postgresql.org/docs/current/sql-grant.html) for more information. From 0ba6076767441caf76ada81eef8f4c5333fa0e8a Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Mon, 25 Sep 2023 15:55:07 +0100 Subject: [PATCH 06/59] Update website/docs/reference/references-overview.md --- website/docs/reference/references-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/references-overview.md b/website/docs/reference/references-overview.md index 37d80104277..40688b2ee65 100644 --- a/website/docs/reference/references-overview.md +++ b/website/docs/reference/references-overview.md @@ -49,7 +49,7 @@ Learn how to add more configurations to your dbt project or adapter, use propert icon="computer"/> From d5b0f093fd4592fa3d19eb846e601a5ec766beb2 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Mon, 25 Sep 2023 15:55:23 +0100 Subject: [PATCH 07/59] Update website/docs/reference/references-overview.md --- website/docs/reference/references-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/references-overview.md b/website/docs/reference/references-overview.md index 40688b2ee65..d967cff4e81 100644 --- a/website/docs/reference/references-overview.md +++ b/website/docs/reference/references-overview.md @@ -55,7 +55,7 @@ Learn how to add more configurations to your dbt project or adapter, use propert icon="computer"/> From 327f3e95fff64d68b36ac11664b7b209738ae3af Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Mon, 25 Sep 2023 15:55:41 +0100 Subject: [PATCH 08/59] Update website/docs/reference/references-overview.md --- website/docs/reference/references-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/references-overview.md b/website/docs/reference/references-overview.md index d967cff4e81..cf3cb909a62 100644 --- a/website/docs/reference/references-overview.md +++ b/website/docs/reference/references-overview.md @@ -67,7 +67,7 @@ Learn how to add more configurations to your dbt project or adapter, use propert icon="computer"/> From a8718ee6132fc4555775764ab995b0b3c43bc5a7 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Mon, 25 Sep 2023 15:55:57 +0100 Subject: [PATCH 09/59] Update website/docs/reference/references-overview.md --- website/docs/reference/references-overview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/references-overview.md b/website/docs/reference/references-overview.md index cf3cb909a62..8a30df0127a 100644 --- a/website/docs/reference/references-overview.md +++ b/website/docs/reference/references-overview.md @@ -61,7 +61,7 @@ Learn how to add more configurations to your dbt project or adapter, use propert icon="computer"/> From a100fa1dd151c0cadb2a2775d12882553d7555ee Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Thu, 26 Oct 2023 11:02:53 +0100 Subject: [PATCH 10/59] add callout to explain the difference --- ...22-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md b/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md index 91ad1080ce6..b5f4049885f 100644 --- a/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md +++ b/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md @@ -12,6 +12,10 @@ date: 2022-05-03 is_featured: true --- +:::info Different from dbt Cloud CLI +This is blog explains how to use the Python library, `dbt-cloud-cli` and create a data catalog app with dbt Cloud artifacts. This is different from the [dbt Cloud CLI](/docs/cloud/cloud-cli-installation), a dbt Cloud-powered tool that allows you to run dbt commands against your dbt Cloud development environment from your local command line. +::: + dbt Cloud is a hosted service that many organizations use for their dbt deployments. Among other things, it provides an interface for creating and managing deployment jobs. When triggered (e.g., cron schedule, API trigger), the jobs generate various artifacts that contain valuable metadata related to the dbt project and the run results. dbt Cloud provides a REST API for managing jobs, run artifacts and other dbt Cloud resources. Data/analytics engineers would often write custom scripts for issuing automated calls to the API using tools [cURL](https://curl.se/) or [Python Requests](https://requests.readthedocs.io/en/latest/). In some cases, the engineers would go on and copy/rewrite them between projects that need to interact with the API. Now, they have a bunch of scripts on their hands that they need to maintain and develop further if business requirements change. If only there was a dedicated tool for interacting with the dbt Cloud API that abstracts away the complexities of the API calls behind an easy-to-use interface… Oh wait, there is: [the dbt-cloud-cli](https://github.com/data-mie/dbt-cloud-cli)! From 4e1b523f0ac8656bedb40d5891a42c9d32948477 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Thu, 26 Oct 2023 14:07:09 +0100 Subject: [PATCH 11/59] adds command per slack feedback --- website/docs/docs/cloud/cloud-cli-installation.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/website/docs/docs/cloud/cloud-cli-installation.md b/website/docs/docs/cloud/cloud-cli-installation.md index 179af745685..20af8da314b 100644 --- a/website/docs/docs/cloud/cloud-cli-installation.md +++ b/website/docs/docs/cloud/cloud-cli-installation.md @@ -270,4 +270,7 @@ If you have dbt Core installed locally, either: You can always uninstall the dbt Cloud CLI to return to using dbt Core. - +
+Why am I receiving a Session occupied error? +If you've ran a dbt command and receive a Session occupied error, you can reattach to your existing session with dbt reattach and then press Control-C and choose to cancel the invocation. +
From be269712d22016281dc36ebba1344255914e3427 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 27 Oct 2023 17:18:38 +0100 Subject: [PATCH 12/59] Update sl-architecture.md add core users to the table [per community slack feedback](https://getdbt.slack.com/archives/C046L0VTVR6/p1698423392183379?thread_ts=1698412926.180799&cid=C046L0VTVR6) --- .../docs/use-dbt-semantic-layer/sl-architecture.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/website/docs/docs/use-dbt-semantic-layer/sl-architecture.md b/website/docs/docs/use-dbt-semantic-layer/sl-architecture.md index dc75016eb91..532afd16a84 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-architecture.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-architecture.md @@ -19,12 +19,12 @@ The dbt Semantic Layer allows you to define metrics and use various interfaces t The dbt Semantic Layer includes the following components: -| Components | Information | Developer plans | Team plans | Enterprise plans | License | +| Components | Information | dbt Core users | dbt Cloud Developer plans | dbt Cloud Team plans | dbt Cloud Enterprise plans | License | | --- | --- | :---: | :---: | :---: | --- | -| **[MetricFlow](/docs/build/about-metricflow)** | MetricFlow in dbt allows users to centrally define their semantic models and metrics with YAML specifications. | ✅ | ✅ | ✅ | BSL package (code is source available) | -| **MetricFlow Server**| A proprietary server that takes metric requests and generates optimized SQL for the specific data platform. | ❌ | ✅ | ✅ | Proprietary, Cloud (Team & Enterprise)| -| **Semantic Layer Gateway** | A service that passes queries to MetricFlow server and executes the SQL generated by MetricFlow against the data platform|

❌| ✅ | ✅ | Proprietary, Cloud (Team & Enterprise) | -| **Semantic Layer APIs** | The interfaces that allow users to submit metric queries using the GraphQL and JDBC APIs. They also serve as the foundation for building first-class integrations with various tools. | ❌ | ✅ | ✅ | Proprietary, Cloud (Team & Enterprise)| +| **[MetricFlow](/docs/build/about-metricflow)** | MetricFlow in dbt allows users to centrally define their semantic models and metrics with YAML specifications. | ✅ | ✅ | ✅ | ✅ | BSL package (code is source available) | +| **MetricFlow Server**| A proprietary server that takes metric requests and generates optimized SQL for the specific data platform. | ❌ | ❌ | ✅ | ✅ | Proprietary, Cloud (Team & Enterprise)| +| **Semantic Layer Gateway** | A service that passes queries to the MetricFlow server and executes the SQL generated by MetricFlow against the data platform|

❌ | ❌ |✅ | ✅ | Proprietary, Cloud (Team & Enterprise) | +| **Semantic Layer APIs** | The interfaces allow users to submit metric queries using GraphQL and JDBC APIs. They also serve as the foundation for building first-class integrations with various tools. | ❌ | ❌ | ✅ | ✅ | Proprietary, Cloud (Team & Enterprise)| ## Related questions From e343573b4eba3d88031785fbeb06d9212f32ee40 Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Mon, 30 Oct 2023 16:38:33 -0400 Subject: [PATCH 13/59] [DRAFT] Migration guide move to docs --- .../core-upgrade}/00-upgrading-to-v1.7.md | 4 +++ .../core-upgrade}/01-upgrading-to-v1.6.md | 4 +++ .../core-upgrade}/02-upgrading-to-v1.5.md | 4 +++ .../03-upgrading-to-dbt-utils-v1.0.md | 4 +++ .../core-upgrade}/04-upgrading-to-v1.4.md | 5 +++ .../core-upgrade}/05-upgrading-to-v1.3.md | 5 +++ .../core-upgrade}/06-upgrading-to-v1.2.md | 5 +++ .../core-upgrade}/07-upgrading-to-v1.1.md | 5 +++ .../core-upgrade}/08-upgrading-to-v1.0.md | 5 +++ .../core-upgrade}/09-upgrading-to-v0.21.md | 5 +++ .../core-upgrade}/10-upgrading-to-v0.20.md | 4 +++ .../11-Older versions/upgrading-to-0-11-0.md | 4 +++ .../11-Older versions/upgrading-to-0-12-0.md | 4 +++ .../11-Older versions/upgrading-to-0-13-0.md | 4 +++ .../11-Older versions/upgrading-to-0-14-0.md | 4 +++ .../11-Older versions/upgrading-to-0-14-1.md | 4 +++ .../11-Older versions/upgrading-to-0-15-0.md | 5 +++ .../11-Older versions/upgrading-to-0-16-0.md | 4 +++ .../11-Older versions/upgrading-to-0-17-0.md | 4 +++ .../11-Older versions/upgrading-to-0-18-0.md | 4 +++ .../11-Older versions/upgrading-to-0-19-0.md | 4 +++ website/sidebars.js | 34 +++++++++---------- website/snippets/_upgrade-move.md | 5 +++ 23 files changed, 113 insertions(+), 17 deletions(-) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/00-upgrading-to-v1.7.md (98%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/01-upgrading-to-v1.6.md (98%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/02-upgrading-to-v1.5.md (99%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/03-upgrading-to-dbt-utils-v1.0.md (99%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/04-upgrading-to-v1.4.md (98%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/05-upgrading-to-v1.3.md (98%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/06-upgrading-to-v1.2.md (97%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/07-upgrading-to-v1.1.md (98%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/08-upgrading-to-v1.0.md (98%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/09-upgrading-to-v0.21.md (98%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/10-upgrading-to-v0.20.md (98%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/11-Older versions/upgrading-to-0-11-0.md (97%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/11-Older versions/upgrading-to-0-12-0.md (81%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/11-Older versions/upgrading-to-0-13-0.md (95%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/11-Older versions/upgrading-to-0-14-0.md (99%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/11-Older versions/upgrading-to-0-14-1.md (98%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/11-Older versions/upgrading-to-0-15-0.md (95%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/11-Older versions/upgrading-to-0-16-0.md (98%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/11-Older versions/upgrading-to-0-17-0.md (99%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/11-Older versions/upgrading-to-0-18-0.md (98%) rename website/docs/{guides/migration/versions => docs/dbt-versions/core-upgrade}/11-Older versions/upgrading-to-0-19-0.md (98%) create mode 100644 website/snippets/_upgrade-move.md diff --git a/website/docs/guides/migration/versions/00-upgrading-to-v1.7.md b/website/docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md similarity index 98% rename from website/docs/guides/migration/versions/00-upgrading-to-v1.7.md rename to website/docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md index f350e8955f7..10e815b1804 100644 --- a/website/docs/guides/migration/versions/00-upgrading-to-v1.7.md +++ b/website/docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md @@ -3,6 +3,10 @@ title: "Upgrading to v1.7 (beta)" description: New features and changes in dbt Core v1.7 --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + ## Resources - [Changelog](https://github.com/dbt-labs/dbt-core/blob/8aaed0e29f9560bc53d9d3e88325a9597318e375/CHANGELOG.md) diff --git a/website/docs/guides/migration/versions/01-upgrading-to-v1.6.md b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md similarity index 98% rename from website/docs/guides/migration/versions/01-upgrading-to-v1.6.md rename to website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md index 50b0ca8bc58..2f1de64d3c5 100644 --- a/website/docs/guides/migration/versions/01-upgrading-to-v1.6.md +++ b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md @@ -3,6 +3,10 @@ title: "Upgrading to v1.6 (latest)" description: New features and changes in dbt Core v1.6 --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + dbt Core v1.6 has three significant areas of focus: 1. Next milestone of [multi-project deployments](https://github.com/dbt-labs/dbt-core/discussions/6725): improvements to contracts, groups/access, versions; and building blocks for cross-project `ref` 1. Semantic layer re-launch: dbt Core and [MetricFlow](https://docs.getdbt.com/docs/build/about-metricflow) integration diff --git a/website/docs/guides/migration/versions/02-upgrading-to-v1.5.md b/website/docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md similarity index 99% rename from website/docs/guides/migration/versions/02-upgrading-to-v1.5.md rename to website/docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md index 0c7fc7ebcad..21e19a6177a 100644 --- a/website/docs/guides/migration/versions/02-upgrading-to-v1.5.md +++ b/website/docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md @@ -3,6 +3,10 @@ title: "Upgrading to v1.5" description: New features and changes in dbt Core v1.5 --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + dbt Core v1.5 is a feature release, with two significant additions: 1. [**Model governance**](/docs/collaborate/govern/about-model-governance) — access, contracts, versions — the first phase of [multi-project deployments](https://github.com/dbt-labs/dbt-core/discussions/6725) 2. A Python entry point for [**programmatic invocations**](/reference/programmatic-invocations), at parity with the CLI diff --git a/website/docs/guides/migration/versions/03-upgrading-to-dbt-utils-v1.0.md b/website/docs/docs/dbt-versions/core-upgrade/03-upgrading-to-dbt-utils-v1.0.md similarity index 99% rename from website/docs/guides/migration/versions/03-upgrading-to-dbt-utils-v1.0.md rename to website/docs/docs/dbt-versions/core-upgrade/03-upgrading-to-dbt-utils-v1.0.md index 72c6fc3c968..a7b302c9a58 100644 --- a/website/docs/guides/migration/versions/03-upgrading-to-dbt-utils-v1.0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/03-upgrading-to-dbt-utils-v1.0.md @@ -3,6 +3,10 @@ title: "Upgrading to dbt utils v1.0" description: New features and breaking changes to consider as you upgrade to dbt utils v1.0. --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + # Upgrading to dbt utils v1.0 For the first time, [dbt utils](https://hub.getdbt.com/dbt-labs/dbt_utils/latest/) is crossing the major version boundary. From [last month’s blog post](https://www.getdbt.com/blog/announcing-dbt-v1.3-and-utils/): diff --git a/website/docs/guides/migration/versions/04-upgrading-to-v1.4.md b/website/docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md similarity index 98% rename from website/docs/guides/migration/versions/04-upgrading-to-v1.4.md rename to website/docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md index 3537eb1677a..19875305729 100644 --- a/website/docs/guides/migration/versions/04-upgrading-to-v1.4.md +++ b/website/docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md @@ -2,6 +2,11 @@ title: "Upgrading to v1.4" description: New features and changes in dbt Core v1.4 --- + +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + ### Resources - [Changelog](https://github.com/dbt-labs/dbt-core/blob/1.4.latest/CHANGELOG.md) diff --git a/website/docs/guides/migration/versions/05-upgrading-to-v1.3.md b/website/docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md similarity index 98% rename from website/docs/guides/migration/versions/05-upgrading-to-v1.3.md rename to website/docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md index 5fdf559a267..ed385ce7e8f 100644 --- a/website/docs/guides/migration/versions/05-upgrading-to-v1.3.md +++ b/website/docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md @@ -2,6 +2,11 @@ title: "Upgrading to v1.3" description: New features and changes in dbt Core v1.3 --- + +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + ### Resources - [Changelog](https://github.com/dbt-labs/dbt-core/blob/1.3.latest/CHANGELOG.md) diff --git a/website/docs/guides/migration/versions/06-upgrading-to-v1.2.md b/website/docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md similarity index 97% rename from website/docs/guides/migration/versions/06-upgrading-to-v1.2.md rename to website/docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md index 91ffadf9093..8b79f6e0dc5 100644 --- a/website/docs/guides/migration/versions/06-upgrading-to-v1.2.md +++ b/website/docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md @@ -2,6 +2,11 @@ title: "Upgrading to v1.2" description: New features and changes in dbt Core v1.2 --- + +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + ### Resources - [Changelog](https://github.com/dbt-labs/dbt-core/blob/1.2.latest/CHANGELOG.md) diff --git a/website/docs/guides/migration/versions/07-upgrading-to-v1.1.md b/website/docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md similarity index 98% rename from website/docs/guides/migration/versions/07-upgrading-to-v1.1.md rename to website/docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md index 131ecc97657..559dac511b3 100644 --- a/website/docs/guides/migration/versions/07-upgrading-to-v1.1.md +++ b/website/docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md @@ -2,6 +2,11 @@ title: "Upgrading to v1.1" description: New features and changes in dbt Core v1.1 --- + +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + ### Resources - [Changelog](https://github.com/dbt-labs/dbt-core/blob/1.1.latest/CHANGELOG.md) diff --git a/website/docs/guides/migration/versions/08-upgrading-to-v1.0.md b/website/docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md similarity index 98% rename from website/docs/guides/migration/versions/08-upgrading-to-v1.0.md rename to website/docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md index 9fc7991c087..60ad63a2577 100644 --- a/website/docs/guides/migration/versions/08-upgrading-to-v1.0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md @@ -2,6 +2,11 @@ title: "Upgrading to v1.0" description: New features and changes in dbt Core v1.0 --- + +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + ### Resources - [Discourse](https://discourse.getdbt.com/t/3180) diff --git a/website/docs/guides/migration/versions/09-upgrading-to-v0.21.md b/website/docs/docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md similarity index 98% rename from website/docs/guides/migration/versions/09-upgrading-to-v0.21.md rename to website/docs/docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md index e5fbdf3fc7c..b2f04ebcb7c 100644 --- a/website/docs/guides/migration/versions/09-upgrading-to-v0.21.md +++ b/website/docs/docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md @@ -3,6 +3,11 @@ title: "Upgrading to v0.21" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + + :::caution Unsupported version dbt Core v0.21 has reached the end of critical support. No new patch versions will be released, and it will stop running in dbt Cloud on June 30, 2022. Read ["About dbt Core versions"](/docs/dbt-versions/core) for more details. ::: diff --git a/website/docs/guides/migration/versions/10-upgrading-to-v0.20.md b/website/docs/docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md similarity index 98% rename from website/docs/guides/migration/versions/10-upgrading-to-v0.20.md rename to website/docs/docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md index 8b33bfa3879..b5952a5396b 100644 --- a/website/docs/guides/migration/versions/10-upgrading-to-v0.20.md +++ b/website/docs/docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md @@ -3,6 +3,10 @@ title: "Upgrading to v0.20" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + :::caution Unsupported version dbt Core v0.20 has reached the end of critical support. No new patch versions will be released, and it will stop running in dbt Cloud on June 30, 2022. Read ["About dbt Core versions"](/docs/dbt-versions/core) for more details. ::: diff --git a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-11-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-11-0.md similarity index 97% rename from website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-11-0.md rename to website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-11-0.md index e307c46fdf9..567bf2d95ff 100644 --- a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-11-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-11-0.md @@ -3,6 +3,10 @@ title: "Upgrading to 0.11.0" id: "upgrading-to-0-11-0" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + ## Schema.yml v2 syntax dbt v0.11.0 adds an auto-generated docs site to your dbt project. To make effective use of the documentation site, you'll need to use the new "version 2" schema.yml syntax. For a full explanation of the version 2 syntax, check out the [schema.yml Files](/reference/configs-and-properties) section of the documentation. diff --git a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-12-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-12-0.md similarity index 81% rename from website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-12-0.md rename to website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-12-0.md index 60900d3c1a4..6df1a0d54e1 100644 --- a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-12-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-12-0.md @@ -3,6 +3,10 @@ title: "Upgrading to 0.12.0" id: "upgrading-to-0-12-0" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + ## End of support Support for the `repositories:` block in `dbt_project.yml` (deprecated in 0.10.0) was removed. diff --git a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-13-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-13-0.md similarity index 95% rename from website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-13-0.md rename to website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-13-0.md index 14a70e177e8..12c62e200fc 100644 --- a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-13-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-13-0.md @@ -3,6 +3,10 @@ title: "Upgrading to 0.13.0" id: "upgrading-to-0-13-0" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + ## Breaking changes ### on-run-start and on-run-end diff --git a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-14-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-0.md similarity index 99% rename from website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-14-0.md rename to website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-0.md index 3b9c8560230..59bc87fa003 100644 --- a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-14-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-0.md @@ -3,6 +3,10 @@ title: "Upgrading to 0.14.0" id: "upgrading-to-0-14-0" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + This guide outlines migration instructions for: 1. [Upgrading archives to snapshots](#upgrading-to-snapshot-blocks) diff --git a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-14-1.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-1.md similarity index 98% rename from website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-14-1.md rename to website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-1.md index a81740d5a68..457222dd9bf 100644 --- a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-14-1.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-1.md @@ -3,6 +3,10 @@ title: "Upgrading to 0.14.1" id: "upgrading-to-0-14-1" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + The dbt v0.14.1 release _does not_ contain any breaking code changes for users upgrading from v0.14.0. If you are upgrading from a version less than 0.14.0, consult the [Upgrading to 0.14.0](upgrading-to-0-14-0) migration guide. The following section contains important information for users of the `check` strategy on Snowflake and BigQuery. Action may be required in your database. ## Changes to the Snapshot "check" algorithm diff --git a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-15-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-15-0.md similarity index 95% rename from website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-15-0.md rename to website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-15-0.md index 02ab297c07a..7b319c33c88 100644 --- a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-15-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-15-0.md @@ -3,8 +3,13 @@ title: "Upgrading to 0.15.0" id: "upgrading-to-0-15-0" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + The dbt v0.15.0 release contains a handful of breaking code changes for users upgrading from v0.14.0. + ## Breaking changes ### Stricter YML compilation diff --git a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-16-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-16-0.md similarity index 98% rename from website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-16-0.md rename to website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-16-0.md index a34f23c4c89..51d6d315dff 100644 --- a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-16-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-16-0.md @@ -3,6 +3,10 @@ title: "Upgrading to 0.16.0" id: "upgrading-to-0-16-0" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + dbt v0.16.0 contains many new features, bug fixes, and improvements. This guide covers all of the important information to consider when upgrading from an earlier version of dbt to 0.16.0. diff --git a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-17-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-17-0.md similarity index 99% rename from website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-17-0.md rename to website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-17-0.md index 1f891ebc0f4..9c82730736c 100644 --- a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-17-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-17-0.md @@ -4,6 +4,10 @@ id: "upgrading-to-0-17-0" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + dbt v0.17.0 makes compilation more consistent, improves performance, and fixes a number of bugs. ## Articles: diff --git a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-18-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-18-0.md similarity index 98% rename from website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-18-0.md rename to website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-18-0.md index 8092ad807b8..1b1b7360836 100644 --- a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-18-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-18-0.md @@ -3,6 +3,10 @@ title: "Upgrading to 0.18.0" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + ### Resources - [Changelog](https://github.com/dbt-labs/dbt-core/blob/dev/marian-anderson/CHANGELOG.md) diff --git a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-19-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-19-0.md similarity index 98% rename from website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-19-0.md rename to website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-19-0.md index 0dd428780e0..5d0d8af04da 100644 --- a/website/docs/guides/migration/versions/11-Older versions/upgrading-to-0-19-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-19-0.md @@ -3,6 +3,10 @@ title: "Upgrading to 0.19.0" --- +import UpgradeMove from '/snippets/_upgrade-move.md'; + + + ### Resources - [Discourse](https://discourse.getdbt.com/t/1951) diff --git a/website/sidebars.js b/website/sidebars.js index 7898715cd0d..cbb48c0e294 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -599,6 +599,23 @@ const sidebarSettings = { "docs/dbt-versions/upgrade-core-in-cloud", "docs/dbt-versions/product-lifecycles", "docs/dbt-versions/experimental-features", + { + type: "category", + label: "dbt Core upgrade guides", + link: { + type: "generated-index", + title: "Version upgrade guides", + description: + "Learn what's new in the latest version of dbt Core.", + slug: "/docs/dbt-versions/core-upgrade", + }, + items: [ + { + type: "autogenerated", + dirName: "docs/dbt-versions/core-upgrade", + }, + ], + }, { type: "category", label: "dbt Cloud Release Notes", @@ -1106,23 +1123,6 @@ const sidebarSettings = { label: "Migration", items: [ "guides/migration/sl-migration", - { - type: "category", - label: "Versions", - link: { - type: "generated-index", - title: "Version migration guides", - description: - "Learn how to upgrade to the latest version of dbt Core.", - slug: "/guides/migration/versions", - }, - items: [ - { - type: "autogenerated", - dirName: "guides/migration/versions", - }, - ], - }, { type: "category", label: "Tools", diff --git a/website/snippets/_upgrade-move.md b/website/snippets/_upgrade-move.md new file mode 100644 index 00000000000..7572077fd1b --- /dev/null +++ b/website/snippets/_upgrade-move.md @@ -0,0 +1,5 @@ +:::important Upgrade Guides Are Moving + +The location of the dbt Core upgrade guides has changed, and they will soon be removed from `Guides`. The new location is in the `Docs` tab under `Available dbt versions`. You have been redirected to the new URL, so please update any saved links and bookmarks. + +::: \ No newline at end of file From 864d2151a803c9006958b2989b1f12d11626842b Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 16:46:31 +0000 Subject: [PATCH 14/59] Create about-database-permissions.md add landing page --- .../about-database-permissions.md | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 website/docs/reference/database-permissions/about-database-permissions.md diff --git a/website/docs/reference/database-permissions/about-database-permissions.md b/website/docs/reference/database-permissions/about-database-permissions.md new file mode 100644 index 00000000000..c348fa23748 --- /dev/null +++ b/website/docs/reference/database-permissions/about-database-permissions.md @@ -0,0 +1,26 @@ +--- +title: "Database permissions" +id: about-database-permissions +description: "Database permissions are access rights and privileges granted to users or roles within a database management system." +sidebar_label: "About database permissions" +--- + + + +Database permissions are access rights and privileges granted to users or roles within a database or data platform. They help you specify what actions users or roles can perform on various database objects, like tables, views, schemas, or even the entire database. + +ARE THEY DIFF FROM MODEL GOVERNANCE BC CONTROLS THE DATABASE PERMISSIONS? + +## Why are they useful + +- Database permissions are essential for security and data access control. +- They ensure that only authorized users can perform specific actions. +- They help maintain data integrity, prevent unauthorized changes, and limit exposure to sensitive data. +- Permissions also support compliance with data privacy regulations and auditing. + +## How to use them + +- Users and administrators can grant and manage permissions using SQL statements or through the database system's interface. +- Assign permissions to individual users or roles (groups of users) based on their responsibilities. + - Typical permissions include "SELECT" (read), "INSERT" (add data), "UPDATE" (modify data), "DELETE" (remove data), and administrative rights like "CREATE" and "DROP." +- Users should be assigned permissions that ensure they have the necessary access to perform their tasks without overextending privileges. From 385bcdbed8b32d66db24536749f574ba8c1e3034 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 16:50:51 +0000 Subject: [PATCH 15/59] Update about-database-permissions.md --- .../about-database-permissions.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/website/docs/reference/database-permissions/about-database-permissions.md b/website/docs/reference/database-permissions/about-database-permissions.md index c348fa23748..2f7cf44899d 100644 --- a/website/docs/reference/database-permissions/about-database-permissions.md +++ b/website/docs/reference/database-permissions/about-database-permissions.md @@ -5,8 +5,6 @@ description: "Database permissions are access rights and privileges granted to u sidebar_label: "About database permissions" --- - - Database permissions are access rights and privileges granted to users or roles within a database or data platform. They help you specify what actions users or roles can perform on various database objects, like tables, views, schemas, or even the entire database. ARE THEY DIFF FROM MODEL GOVERNANCE BC CONTROLS THE DATABASE PERMISSIONS? @@ -24,3 +22,12 @@ ARE THEY DIFF FROM MODEL GOVERNANCE BC CONTROLS THE DATABASE PERMISSIONS? - Assign permissions to individual users or roles (groups of users) based on their responsibilities. - Typical permissions include "SELECT" (read), "INSERT" (add data), "UPDATE" (modify data), "DELETE" (remove data), and administrative rights like "CREATE" and "DROP." - Users should be assigned permissions that ensure they have the necessary access to perform their tasks without overextending privileges. + +## Examples + +For more info on examples and how to setup database permissions, refer to the following database permission pages: + +- [Databricks](/reference/database-permissions/databricks-permissions) +- [Postgres](/reference/database-permissions/postgres-permissions) +- [Redshift](/reference/database-permissions/redshift-permissions) +- [Snowflake](/reference/database-permissions/snowflake-permissions) From 14691d83921c8fa8b46c42ff42bb9bab7d2aa0e4 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 16:54:52 +0000 Subject: [PATCH 16/59] Update snowflake-permissions.md --- .../database-permissions/snowflake-permissions.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/website/docs/reference/database-permissions/snowflake-permissions.md b/website/docs/reference/database-permissions/snowflake-permissions.md index 6a469d12230..500a0844a95 100644 --- a/website/docs/reference/database-permissions/snowflake-permissions.md +++ b/website/docs/reference/database-permissions/snowflake-permissions.md @@ -1,12 +1,16 @@ --- -title: "Snowflake Permissions" +title: "Snowflake permissions" --- +In Snowflake, permissions are used to control who can perform certain actions on different database objects. Use SQL statements to manage permissions in a Snowflake database. + ## Example Snowflake permissions +The following example provides you with the SQL statements you can use to manage permissions. + +**Notes that `warehouse_name`, `database_name`, and `role_name` are placeholders and you can replace them as-needed for your organization's naming convention. + ``` --- NOTE: warehouse_name, database_name, and role_name are placeholders! --- Replace as-needed for your organization's naming convention! grant all on warehouse warehouse_name to role role_name; grant usage on database database_name to role role_name; @@ -23,3 +27,5 @@ grant monitor on all schemas in database database_name to role role_name; grant select on all tables in database database_name to role role_name; grant select on all views in database database_name to role role_name; ``` + +For more info on the privileges how to set up your Snowflake account, refer to [this Discourse article](https://discourse.getdbt.com/t/setting-up-snowflake-the-exact-grant-statements-we-run/439). From 9ef7714151250158db5a9c1f34a9b5a495d121b3 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 16:57:25 +0000 Subject: [PATCH 17/59] Update databricks-permissions.md --- .../database-permissions/databricks-permissions.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/databricks-permissions.md b/website/docs/reference/database-permissions/databricks-permissions.md index 5bfe1c9252a..99c1d054751 100644 --- a/website/docs/reference/database-permissions/databricks-permissions.md +++ b/website/docs/reference/database-permissions/databricks-permissions.md @@ -1,9 +1,15 @@ --- -title: "Databricks Permissions" +title: "Databricks permissions" --- +In Databricks, permissions are used to control who can perform certain actions on different database objects. Use SQL statements to manage permissions in a Databricks database. + ## Example Databricks permissions +The following example provides you with the SQL statements you can use to manage permissions. + +**Note that you can grant permissions on `securable_objects` to `principals` (This can be user, service principal, or group). For example, `grant privilege_type` on `securable_object` to `principal`. + ``` -- NOTE: in general permissions can be granted on securable_objects to principals (can be user, service principal, or group) From 6ff0cd34be99eecba6c26b78e7ffcd58bf3e2abe Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 16:57:42 +0000 Subject: [PATCH 18/59] Update databricks-permissions.md --- .../reference/database-permissions/databricks-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/databricks-permissions.md b/website/docs/reference/database-permissions/databricks-permissions.md index 99c1d054751..8183fc9473e 100644 --- a/website/docs/reference/database-permissions/databricks-permissions.md +++ b/website/docs/reference/database-permissions/databricks-permissions.md @@ -8,7 +8,7 @@ In Databricks, permissions are used to control who can perform certain actions o The following example provides you with the SQL statements you can use to manage permissions. -**Note that you can grant permissions on `securable_objects` to `principals` (This can be user, service principal, or group). For example, `grant privilege_type` on `securable_object` to `principal`. +**Note** that you can grant permissions on `securable_objects` to `principals` (This can be user, service principal, or group). For example, `grant privilege_type` on `securable_object` to `principal`. ``` -- NOTE: in general permissions can be granted on securable_objects to From bcd6cc130a0c904b96532936b959639760e475a3 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 16:57:57 +0000 Subject: [PATCH 19/59] Update snowflake-permissions.md --- .../reference/database-permissions/snowflake-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/snowflake-permissions.md b/website/docs/reference/database-permissions/snowflake-permissions.md index 500a0844a95..507202d4d71 100644 --- a/website/docs/reference/database-permissions/snowflake-permissions.md +++ b/website/docs/reference/database-permissions/snowflake-permissions.md @@ -8,7 +8,7 @@ In Snowflake, permissions are used to control who can perform certain actions on The following example provides you with the SQL statements you can use to manage permissions. -**Notes that `warehouse_name`, `database_name`, and `role_name` are placeholders and you can replace them as-needed for your organization's naming convention. +**Note** that `warehouse_name`, `database_name`, and `role_name` are placeholders and you can replace them as-needed for your organization's naming convention. ``` From 8c8140d95f11230f39f321673c692ae4a5454f92 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 16:59:29 +0000 Subject: [PATCH 20/59] Update postgres-permissions.md --- .../reference/database-permissions/postgres-permissions.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/website/docs/reference/database-permissions/postgres-permissions.md b/website/docs/reference/database-permissions/postgres-permissions.md index 24bb91317cc..3de71d14b77 100644 --- a/website/docs/reference/database-permissions/postgres-permissions.md +++ b/website/docs/reference/database-permissions/postgres-permissions.md @@ -2,8 +2,15 @@ title: "Postgres Permissions" --- + +In Postgres, permissions are used to control who can perform certain actions on different database objects. Use SQL statements to manage permissions in a Databricks database. + ## Example Postgres permissions +The following example provides you with the SQL statements you can use to manage permissions. + +**Note** that `database_name`, `database.schema_name`, and `user_name` are placeholders and you can replace them as needed for your organization's naming convention. + ``` grant usage on database database_name to user_name; grant create schema on database database_name to user_name; From e900d23d511bfa501ce4fcb6cea124d60ba8d120 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 17:03:22 +0000 Subject: [PATCH 21/59] Update redshift-permissions.md --- .../database-permissions/redshift-permissions.md | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/redshift-permissions.md b/website/docs/reference/database-permissions/redshift-permissions.md index f173e2584d4..2da4ae7f0be 100644 --- a/website/docs/reference/database-permissions/redshift-permissions.md +++ b/website/docs/reference/database-permissions/redshift-permissions.md @@ -1,9 +1,16 @@ --- -title: "Redshift Permissions" +title: "Redshift permissions" --- +In Redshift, permissions are used to control who can perform certain actions on different database objects. Use SQL statements to manage permissions in a Databricks database. + ## Example Redshift permissions +The following example provides you with the SQL statements you can use to manage permissions. + +**Note** that `database_name`, `database.schema_name`, and `user_name` are placeholders and you can replace them as needed for your organization's naming convention. + + ``` grant usage on database database_name to user_name; grant create schema on database database_name to user_name; From 425cd0f281259744291b84ae63be915e818d5930 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 17:06:03 +0000 Subject: [PATCH 22/59] Update redshift-permissions.md --- .../docs/reference/database-permissions/redshift-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/redshift-permissions.md b/website/docs/reference/database-permissions/redshift-permissions.md index 2da4ae7f0be..5f0949a3528 100644 --- a/website/docs/reference/database-permissions/redshift-permissions.md +++ b/website/docs/reference/database-permissions/redshift-permissions.md @@ -2,7 +2,7 @@ title: "Redshift permissions" --- -In Redshift, permissions are used to control who can perform certain actions on different database objects. Use SQL statements to manage permissions in a Databricks database. +In Redshift, permissions are used to control who can perform certain actions on different database objects. Use SQL statements to manage permissions in a Redshift database. ## Example Redshift permissions From 84416147abfbe3d0ba97af5cee4f74902211d82f Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 17:06:21 +0000 Subject: [PATCH 23/59] Update postgres-permissions.md --- .../docs/reference/database-permissions/postgres-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/postgres-permissions.md b/website/docs/reference/database-permissions/postgres-permissions.md index 3de71d14b77..942f11321b1 100644 --- a/website/docs/reference/database-permissions/postgres-permissions.md +++ b/website/docs/reference/database-permissions/postgres-permissions.md @@ -3,7 +3,7 @@ title: "Postgres Permissions" --- -In Postgres, permissions are used to control who can perform certain actions on different database objects. Use SQL statements to manage permissions in a Databricks database. +In Postgres, permissions are used to control who can perform certain actions on different database objects. Use SQL statements to manage permissions in a Postgres database. ## Example Postgres permissions From 6cd75895be534fc2b16505bda8d54a5843b00ade Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Tue, 31 Oct 2023 17:06:44 +0000 Subject: [PATCH 24/59] Update databricks-permissions.md --- .../reference/database-permissions/databricks-permissions.md | 3 --- 1 file changed, 3 deletions(-) diff --git a/website/docs/reference/database-permissions/databricks-permissions.md b/website/docs/reference/database-permissions/databricks-permissions.md index 8183fc9473e..12e24652ae3 100644 --- a/website/docs/reference/database-permissions/databricks-permissions.md +++ b/website/docs/reference/database-permissions/databricks-permissions.md @@ -11,9 +11,6 @@ The following example provides you with the SQL statements you can use to manage **Note** that you can grant permissions on `securable_objects` to `principals` (This can be user, service principal, or group). For example, `grant privilege_type` on `securable_object` to `principal`. ``` --- NOTE: in general permissions can be granted on securable_objects to -principals (can be user, service principal, or group) --- e.g.: grant privilege_type on securable_object to principal grant all privileges on schema schema_name to principal; grant create table on schema schema_name to principal; From a9eb215a2d56b904ea86d6f17130deea67e0f4eb Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Tue, 31 Oct 2023 16:37:31 -0400 Subject: [PATCH 25/59] Moving migration pages --- .../core-upgrade/00-upgrading-to-v1.7.md | 1 + .../core-upgrade/01-upgrading-to-v1.6.md | 1 + .../core-upgrade/02-upgrading-to-v1.5.md | 1 + .../core-upgrade/04-upgrading-to-v1.4.md | 1 + .../core-upgrade/05-upgrading-to-v1.3.md | 1 + .../core-upgrade/06-upgrading-to-v1.2.md | 1 + .../core-upgrade/07-upgrading-to-v1.1.md | 1 + .../core-upgrade/08-upgrading-to-v1.0.md | 1 + .../core-upgrade/09-upgrading-to-v0.21.md | 1 + .../core-upgrade/10-upgrading-to-v0.20.md | 1 + website/sidebars.js | 14 ++++++++++++++ 11 files changed, 24 insertions(+) diff --git a/website/docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md b/website/docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md index 10e815b1804..e87171ffc28 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md +++ b/website/docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md @@ -1,5 +1,6 @@ --- title: "Upgrading to v1.7 (beta)" +id: upgrading-to-v1.7 description: New features and changes in dbt Core v1.7 --- diff --git a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md index 2f1de64d3c5..2794bfd8c4d 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md +++ b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md @@ -1,6 +1,7 @@ --- title: "Upgrading to v1.6 (latest)" description: New features and changes in dbt Core v1.6 +id: "upgrading-to-v1.6" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md b/website/docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md index 21e19a6177a..3319d19697e 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md +++ b/website/docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md @@ -1,6 +1,7 @@ --- title: "Upgrading to v1.5" description: New features and changes in dbt Core v1.5 +id: "upgrading-to-v1.5" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md b/website/docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md index 19875305729..faa47c49eb4 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md +++ b/website/docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md @@ -1,6 +1,7 @@ --- title: "Upgrading to v1.4" description: New features and changes in dbt Core v1.4 +id: "upgrading-to-v1.4" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md b/website/docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md index ed385ce7e8f..a3450c44561 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md +++ b/website/docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md @@ -1,6 +1,7 @@ --- title: "Upgrading to v1.3" description: New features and changes in dbt Core v1.3 +id: "upgrading-to-v1.3" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md b/website/docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md index 8b79f6e0dc5..5ab98c0883b 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md +++ b/website/docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md @@ -1,6 +1,7 @@ --- title: "Upgrading to v1.2" description: New features and changes in dbt Core v1.2 +id: "upgrading-to-v1.2" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md b/website/docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md index 559dac511b3..0a338923392 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md +++ b/website/docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md @@ -1,6 +1,7 @@ --- title: "Upgrading to v1.1" description: New features and changes in dbt Core v1.1 +id: "upgrading-to-v1.1" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md b/website/docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md index 60ad63a2577..1da16c3ee72 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md @@ -1,6 +1,7 @@ --- title: "Upgrading to v1.0" description: New features and changes in dbt Core v1.0 +id: "upgrading-to-v1.0" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md b/website/docs/docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md index b2f04ebcb7c..d24ca4f6ef0 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md +++ b/website/docs/docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md @@ -1,5 +1,6 @@ --- title: "Upgrading to v0.21" +id: "upgrading-to-v0.21" --- diff --git a/website/docs/docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md b/website/docs/docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md index b5952a5396b..87cb70fbe10 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md +++ b/website/docs/docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md @@ -1,5 +1,6 @@ --- title: "Upgrading to v0.20" +id: "upgrading-to-v0.20" --- diff --git a/website/sidebars.js b/website/sidebars.js index cbb48c0e294..a425ced8d70 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -1123,6 +1123,20 @@ const sidebarSettings = { label: "Migration", items: [ "guides/migration/sl-migration", + { + type: "category", + label: "Versions", + items: [ + "docs/dbt-versions/core-upgrade/upgrading-to-v1.7", + "docs/dbt-versions/core-upgrade/upgrading-to-v1.6", + "docs/dbt-versions/core-upgrade/upgrading-to-v1.5", + "docs/dbt-versions/core-upgrade/upgrading-to-v1.4", + "docs/dbt-versions/core-upgrade/upgrading-to-v1.3", + "docs/dbt-versions/core-upgrade/upgrading-to-v1.2", + "docs/dbt-versions/core-upgrade/upgrading-to-v1.1", + "docs/dbt-versions/core-upgrade/upgrading-to-v1.0", + ], + }, { type: "category", label: "Tools", From 7196b3709f90e1eccee49f3af743f7104e61819b Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 12:27:21 +0000 Subject: [PATCH 26/59] Update website/docs/reference/database-permissions/about-database-permissions.md --- .../database-permissions/about-database-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/about-database-permissions.md b/website/docs/reference/database-permissions/about-database-permissions.md index 2f7cf44899d..49cf5af31a2 100644 --- a/website/docs/reference/database-permissions/about-database-permissions.md +++ b/website/docs/reference/database-permissions/about-database-permissions.md @@ -25,7 +25,7 @@ ARE THEY DIFF FROM MODEL GOVERNANCE BC CONTROLS THE DATABASE PERMISSIONS? ## Examples -For more info on examples and how to setup database permissions, refer to the following database permission pages: +Refer to the following database permission pages for more info on examples and how to setup database permissions: - [Databricks](/reference/database-permissions/databricks-permissions) - [Postgres](/reference/database-permissions/postgres-permissions) From 77beb97c165029e66a21c461a7b1185c1126aa2b Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 12:29:53 +0000 Subject: [PATCH 27/59] Update website/docs/reference/database-permissions/about-database-permissions.md --- .../reference/database-permissions/about-database-permissions.md | 1 + 1 file changed, 1 insertion(+) diff --git a/website/docs/reference/database-permissions/about-database-permissions.md b/website/docs/reference/database-permissions/about-database-permissions.md index 49cf5af31a2..861f256e975 100644 --- a/website/docs/reference/database-permissions/about-database-permissions.md +++ b/website/docs/reference/database-permissions/about-database-permissions.md @@ -23,6 +23,7 @@ ARE THEY DIFF FROM MODEL GOVERNANCE BC CONTROLS THE DATABASE PERMISSIONS? - Typical permissions include "SELECT" (read), "INSERT" (add data), "UPDATE" (modify data), "DELETE" (remove data), and administrative rights like "CREATE" and "DROP." - Users should be assigned permissions that ensure they have the necessary access to perform their tasks without overextending privileges. +Something to note is that each data platform provider might have different approaches and names for privileges. Refer to their documentation for more details. ## Examples Refer to the following database permission pages for more info on examples and how to setup database permissions: From 5b75635509d1a88daf59680802a974226549b200 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 12:34:49 +0000 Subject: [PATCH 28/59] Update website/docs/reference/database-permissions/about-database-permissions.md --- .../reference/database-permissions/about-database-permissions.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/reference/database-permissions/about-database-permissions.md b/website/docs/reference/database-permissions/about-database-permissions.md index 861f256e975..22ffab2137d 100644 --- a/website/docs/reference/database-permissions/about-database-permissions.md +++ b/website/docs/reference/database-permissions/about-database-permissions.md @@ -7,7 +7,6 @@ sidebar_label: "About database permissions" Database permissions are access rights and privileges granted to users or roles within a database or data platform. They help you specify what actions users or roles can perform on various database objects, like tables, views, schemas, or even the entire database. -ARE THEY DIFF FROM MODEL GOVERNANCE BC CONTROLS THE DATABASE PERMISSIONS? ## Why are they useful From 0bd0d3225c43c07b6cbe3eb26ab10831f4714da8 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 12:36:30 +0000 Subject: [PATCH 29/59] Update sidebars.js --- website/sidebars.js | 2 ++ 1 file changed, 2 insertions(+) diff --git a/website/sidebars.js b/website/sidebars.js index b0f999aba40..dcead393882 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -936,7 +936,9 @@ const sidebarSettings = { { type: "category", label: "Database Permissions", + link: { type: "doc", id: "reference/database-permissions/about-database-permissions" }, items: [ + "reference/database-permissions/about-database-permissions" "reference/database-permissions/snowflake-permissions", "reference/database-permissions/databricks-permissions", "reference/database-permissions/redshift-permissions", From 325893705e7d6e68df58ff43895d6cf19dcd001b Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 12:37:08 +0000 Subject: [PATCH 30/59] Update about-database-permissions.md --- .../database-permissions/about-database-permissions.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/website/docs/reference/database-permissions/about-database-permissions.md b/website/docs/reference/database-permissions/about-database-permissions.md index 22ffab2137d..c8af3876416 100644 --- a/website/docs/reference/database-permissions/about-database-permissions.md +++ b/website/docs/reference/database-permissions/about-database-permissions.md @@ -3,6 +3,8 @@ title: "Database permissions" id: about-database-permissions description: "Database permissions are access rights and privileges granted to users or roles within a database management system." sidebar_label: "About database permissions" +pagination_next: "reference/database-permissions/databricks-permissions" +pagination_prev: null --- Database permissions are access rights and privileges granted to users or roles within a database or data platform. They help you specify what actions users or roles can perform on various database objects, like tables, views, schemas, or even the entire database. From caa0c5d54bae80827caac5a6fbd9ae78755817f7 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 12:39:11 +0000 Subject: [PATCH 31/59] Update sidebars.js --- website/sidebars.js | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/website/sidebars.js b/website/sidebars.js index dcead393882..75f9a7ae364 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -939,10 +939,10 @@ const sidebarSettings = { link: { type: "doc", id: "reference/database-permissions/about-database-permissions" }, items: [ "reference/database-permissions/about-database-permissions" - "reference/database-permissions/snowflake-permissions", "reference/database-permissions/databricks-permissions", - "reference/database-permissions/redshift-permissions", "reference/database-permissions/postgres-permissions", + "reference/database-permissions/redshift-permissions", + "reference/database-permissions/snowflake-permissions", ], }, ], From e212d17a5d3f0102746f29b05ffcb24148917ba2 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 13:38:06 +0000 Subject: [PATCH 32/59] Update website/docs/reference/database-permissions/postgres-permissions.md --- .../docs/reference/database-permissions/postgres-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/postgres-permissions.md b/website/docs/reference/database-permissions/postgres-permissions.md index 942f11321b1..da56e9b45f2 100644 --- a/website/docs/reference/database-permissions/postgres-permissions.md +++ b/website/docs/reference/database-permissions/postgres-permissions.md @@ -7,7 +7,7 @@ In Postgres, permissions are used to control who can perform certain actions on ## Example Postgres permissions -The following example provides you with the SQL statements you can use to manage permissions. +The following example provides you with the SQL statements you can use to manage permissions. These examples allow you to run dbt smoothly without encountering permission issues, such as creating schemas, reading existing data, and accessing the information schema. **Note** that `database_name`, `database.schema_name`, and `user_name` are placeholders and you can replace them as needed for your organization's naming convention. From 4a874a765ba30c0c00c099bab307966ee180961d Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 14:42:33 +0000 Subject: [PATCH 33/59] Update website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md --- ...2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md b/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md index b5f4049885f..2ec00735161 100644 --- a/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md +++ b/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md @@ -13,7 +13,7 @@ is_featured: true --- :::info Different from dbt Cloud CLI -This is blog explains how to use the Python library, `dbt-cloud-cli` and create a data catalog app with dbt Cloud artifacts. This is different from the [dbt Cloud CLI](/docs/cloud/cloud-cli-installation), a dbt Cloud-powered tool that allows you to run dbt commands against your dbt Cloud development environment from your local command line. +This is blog explains how to use the Python library, `dbt-cloud-cli`, and create a data catalog app with dbt Cloud artifacts. This is different from the [dbt Cloud CLI](/docs/cloud/cloud-cli-installation), a dbt Cloud-powered tool that allows you to run dbt commands against your dbt Cloud development environment from your local command line. ::: dbt Cloud is a hosted service that many organizations use for their dbt deployments. Among other things, it provides an interface for creating and managing deployment jobs. When triggered (e.g., cron schedule, API trigger), the jobs generate various artifacts that contain valuable metadata related to the dbt project and the run results. From 97f5594a0d0b66d266d4a06a824f296b53187a4a Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 14:44:04 +0000 Subject: [PATCH 34/59] Update website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md --- ...2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md b/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md index 2ec00735161..3bb04801579 100644 --- a/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md +++ b/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md @@ -13,7 +13,7 @@ is_featured: true --- :::info Different from dbt Cloud CLI -This is blog explains how to use the Python library, `dbt-cloud-cli`, and create a data catalog app with dbt Cloud artifacts. This is different from the [dbt Cloud CLI](/docs/cloud/cloud-cli-installation), a dbt Cloud-powered tool that allows you to run dbt commands against your dbt Cloud development environment from your local command line. +This blog explains how to use the `dbt-cloud-cli` Python library to create a data catalog app with dbt Cloud artifacts. This is different from the [dbt Cloud CLI](/docs/cloud/cloud-cli-installation), a tool that allows you to run dbt commands against your dbt Cloud development environment from your local command line ::: dbt Cloud is a hosted service that many organizations use for their dbt deployments. Among other things, it provides an interface for creating and managing deployment jobs. When triggered (e.g., cron schedule, API trigger), the jobs generate various artifacts that contain valuable metadata related to the dbt project and the run results. From 2de4815e79fe12118418924588aa999251362d09 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 14:44:16 +0000 Subject: [PATCH 35/59] Update website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md --- ...2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md b/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md index 3bb04801579..2ee774d4f1d 100644 --- a/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md +++ b/website/blog/2022-05-03-making-dbt-cloud-api-calls-using-dbt-cloud-cli.md @@ -13,7 +13,7 @@ is_featured: true --- :::info Different from dbt Cloud CLI -This blog explains how to use the `dbt-cloud-cli` Python library to create a data catalog app with dbt Cloud artifacts. This is different from the [dbt Cloud CLI](/docs/cloud/cloud-cli-installation), a tool that allows you to run dbt commands against your dbt Cloud development environment from your local command line +This blog explains how to use the `dbt-cloud-cli` Python library to create a data catalog app with dbt Cloud artifacts. This is different from the [dbt Cloud CLI](/docs/cloud/cloud-cli-installation), a tool that allows you to run dbt commands against your dbt Cloud development environment from your local command line. ::: dbt Cloud is a hosted service that many organizations use for their dbt deployments. Among other things, it provides an interface for creating and managing deployment jobs. When triggered (e.g., cron schedule, API trigger), the jobs generate various artifacts that contain valuable metadata related to the dbt project and the run results. From c241eaf55a8fe4c1bc470f7da93215f068a17db8 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 16:09:26 +0000 Subject: [PATCH 36/59] Update dbt-commands.md update order --- website/docs/reference/dbt-commands.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/website/docs/reference/dbt-commands.md b/website/docs/reference/dbt-commands.md index 1448d9849d3..4bc3ddc24d7 100644 --- a/website/docs/reference/dbt-commands.md +++ b/website/docs/reference/dbt-commands.md @@ -28,6 +28,7 @@ You can run dbt commands in your specific tool by prefixing them with `dbt`. Fo | [deps](/reference/commands/deps) | Downloads dependencies for a project | All | All [supported versions](/docs/dbt-versions/core) | | [docs](/reference/commands/cmd-docs) | Generates documentation for a project | All | All [supported versions](/docs/dbt-versions/core) | | help | Displays help information for any command | dbt Core
dbt Cloud CLI | All [supported versions](/docs/dbt-versions/core) | +| [init](/reference/commands/init) | Initializes a new dbt project | dbt Core | All [supported versions](/docs/dbt-versions/core) | | [list](/reference/commands/list) | Lists resources defined in a dbt project | All | All [supported versions](/docs/dbt-versions/core) | | [parse](/reference/commands/parse) | Parses a project and writes detailed timing info | All | All [supported versions](/docs/dbt-versions/core) | | reattach | Reattaches to the most recent invocation to retrieve logs and artifacts. | dbt Cloud CLI | Requires [dbt v1.6 or higher](/docs/dbt-versions/core) | @@ -39,7 +40,7 @@ You can run dbt commands in your specific tool by prefixing them with `dbt`. Fo | [snapshot](/reference/commands/snapshot) | Executes "snapshot" jobs defined in a project | All | All [supported versions](/docs/dbt-versions/core) | | [source](/reference/commands/source) | Provides tools for working with source data (including validating that sources are "fresh") | All | All [supported versions](/docs/dbt-versions/core) | | [test](/reference/commands/test) | Executes tests defined in a project | All | All [supported versions](/docs/dbt-versions/core) | -| [init](/reference/commands/init) | Initializes a new dbt project | dbt Core | All [supported versions](/docs/dbt-versions/core) | + From f9e18c9d355348815e33b625917ef0f44b86ec78 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 17:21:31 +0000 Subject: [PATCH 37/59] Update teradata-setup.md add terms and conditions link --- website/docs/docs/core/connect-data-platform/teradata-setup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/core/connect-data-platform/teradata-setup.md b/website/docs/docs/core/connect-data-platform/teradata-setup.md index bcda41c8fe9..db544021fe7 100644 --- a/website/docs/docs/core/connect-data-platform/teradata-setup.md +++ b/website/docs/docs/core/connect-data-platform/teradata-setup.md @@ -244,4 +244,4 @@ The adapter was originally created by [Doug Beatty](https://github.com/dbeatty10 ## License -The adapter is published using Apache-2.0 License. Please see the link (ADD LINK HERE) for terms and conditions, such as creating derivative work and the support model. +The adapter is published using Apache-2.0 License. Refer to the [terms and conditions](https://github.com/dbt-labs/dbt-core/blob/main/License.md) to understand items such as creating derivative work and the support model. From 03ddf3ebdeffbabb1e828a55142015912a929819 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 17:35:33 +0000 Subject: [PATCH 38/59] Update snowflake-permissions.md adding discourse article to resolves issue https://github.com/dbt-labs/docs.getdbt.com/issues/3824 --- .../snowflake-permissions.md | 126 +++++++++++++++++- 1 file changed, 124 insertions(+), 2 deletions(-) diff --git a/website/docs/reference/database-permissions/snowflake-permissions.md b/website/docs/reference/database-permissions/snowflake-permissions.md index 507202d4d71..637fecf09cc 100644 --- a/website/docs/reference/database-permissions/snowflake-permissions.md +++ b/website/docs/reference/database-permissions/snowflake-permissions.md @@ -4,11 +4,134 @@ title: "Snowflake permissions" In Snowflake, permissions are used to control who can perform certain actions on different database objects. Use SQL statements to manage permissions in a Snowflake database. +## Set up Snowflake account + +This section will explain the exact privileges it takes to set up your Snowflake account: + +1. Set up databases +``` +use role sysadmin; +create database raw; +create database analytics; +``` +2. Set up warehouses +``` +create warehouse loading + warehouse_size = xsmall + auto_suspend = 3600 + auto_resume = false + initially_suspended = true; + +create warehouse transforming + warehouse_size = xsmall + auto_suspend = 60 + auto_resume = true + initially_suspended = true; + +create warehouse reporting + warehouse_size = xsmall + auto_suspend = 60 + auto_resume = true + initially_suspended = true; +``` + +3. Set up roles and warehouse permissions +``` +use role securityadmin; + +create role loader; +grant all on warehouse loading to role loader; + +create role transformer; +grant all on warehouse transforming to role transformer; + +create role reporter; +grant all on warehouse reporting to role reporter; +``` + +4. Create users, assigning them to their roles +Every person and application gets a separate user and is assigned to the correct role. + +``` +create user stitch_user -- or fivetran_user + password = '_generate_this_' + default_warehouse = loading + default_role = loader; + +create user claire -- or amy, jeremy, etc. + password = '_generate_this_' + default_warehouse = transforming + default_role = transformer + must_change_password = true; + +create user dbt_cloud_user + password = '_generate_this_' + default_warehouse = transforming + default_role = transformer; + +create user looker_user -- or mode_user etc. + password = '_generate_this_' + default_warehouse = reporting + default_role = reporter; + +-- then grant these roles to each user +grant role loader to user stitch_user; -- or fivetran_user +grant role transformer to user dbt_cloud_user; +grant role transformer to user claire; -- or amy, jeremy +grant role reporter to user looker_user; -- or mode_user, periscope_user +``` + +5. Let loader load data +Give the role unilateral permission to operate on the raw database +``` +use role sysadmin; +grant all on database raw to role loader; +``` + +6. Let transformer transform data +The transformer role needs to be able to read raw data. + +If you do this before you have any data loaded, you can run: +``` +grant usage on database raw to role transformer; +grant usage on future schemas in database raw to role transformer; +grant select on future tables in database raw to role transformer; +grant select on future views in database raw to role transformer; +``` +If you already have data loaded in the raw database, make sure also you run the following to update the permissions +``` +grant usage on all schemas in database raw to role transformer; +grant select on all tables in database raw to role transformer; +grant select on all views in database raw to role transformer; +``` +transformer also needs to be able to create in the analytics database: +``` +grant all on database analytics to role transformer; +``` +7. Let reporter read the transformed data +A previous version of this article recommended this be implemented through hooks in dbt, but this way lets you get away with a one-off statement. +``` +grant usage on database analytics to role reporter; +grant usage on future schemas in database analytics to role reporter; +grant select on future tables in database analytics to role reporter; +grant select on future views in database analytics to role reporter; +``` +Again, if you already have data in your analytics database, make sure you run: +``` +grant usage on all schemas in database analytics to role reporter; +grant select on all tables in database analytics to role transformer; +grant select on all views in database analytics to role transformer; +``` +8. Maintain +When new users are added, make sure you add them to the right role! Everything else should be inherited automatically thanks to those `future` grants. + +For more discussion and legacy information, refer to [this Discourse article](https://discourse.getdbt.com/t/setting-up-snowflake-the-exact-grant-statements-we-run/439). + ## Example Snowflake permissions The following example provides you with the SQL statements you can use to manage permissions. -**Note** that `warehouse_name`, `database_name`, and `role_name` are placeholders and you can replace them as-needed for your organization's naming convention. +**Note** that `warehouse_name`, `database_name`, and `role_name` are placeholders and you can replace them as needed for your organization's naming convention. ``` @@ -28,4 +151,3 @@ grant select on all tables in database database_name to role role_name; grant select on all views in database database_name to role role_name; ``` -For more info on the privileges how to set up your Snowflake account, refer to [this Discourse article](https://discourse.getdbt.com/t/setting-up-snowflake-the-exact-grant-statements-we-run/439). From dace850a9a001e598513281b640ca551d3593447 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 17:37:38 +0000 Subject: [PATCH 39/59] Update sidebars.js --- website/sidebars.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/sidebars.js b/website/sidebars.js index 75f9a7ae364..6f6bf008268 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -936,7 +936,7 @@ const sidebarSettings = { { type: "category", label: "Database Permissions", - link: { type: "doc", id: "reference/database-permissions/about-database-permissions" }, + // link: { type: "doc", id: "reference/database-permissions/about-database-permissions" }, items: [ "reference/database-permissions/about-database-permissions" "reference/database-permissions/databricks-permissions", From b08a9af0337f259cd0c5d4cb40fc7ab8cf9cdecd Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 17:38:24 +0000 Subject: [PATCH 40/59] Update website/docs/faqs/Warehouse/database-privileges.md --- website/docs/faqs/Warehouse/database-privileges.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/faqs/Warehouse/database-privileges.md b/website/docs/faqs/Warehouse/database-privileges.md index 692b67f4e0a..3761b81fe67 100644 --- a/website/docs/faqs/Warehouse/database-privileges.md +++ b/website/docs/faqs/Warehouse/database-privileges.md @@ -13,7 +13,7 @@ schema¹ `information_schema`) On Postgres, Redshift, Databricks, and Snowflake, use a series of `grants` to ensure that -your user has the correct privileges. Check out [example permissions](/reference/database-permissions/snowflake-permissions) for these warehouses. +your user has the correct privileges. Check out [example permissions](/reference/database-permissions/about-database-permissions) for these warehouses. On BigQuery, use the "BigQuery User" role to assign these privileges. From b5b4795cd15e0b392c107512669a838c227cc951 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 17:41:51 +0000 Subject: [PATCH 41/59] Update connect-databricks.md --- .../docs/docs/cloud/connect-data-platform/connect-databricks.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/website/docs/docs/cloud/connect-data-platform/connect-databricks.md b/website/docs/docs/cloud/connect-data-platform/connect-databricks.md index b66f5890c61..032246ad16a 100644 --- a/website/docs/docs/cloud/connect-data-platform/connect-databricks.md +++ b/website/docs/docs/cloud/connect-data-platform/connect-databricks.md @@ -26,6 +26,8 @@ Unity Catalog allows Databricks users to centrally manage all data assets, simpl To learn how to optimize performance with data platform-specific configurations in dbt Cloud, refer to [Databricks-specific configuration](/reference/resource-configs/databricks-configs). +To grant users or roles database permissions (access rights and privileges), refer to the [example permissions](/reference/database-permissions/databricks-permissions) page. + To set up the Databricks connection, supply the following fields: From 12461016d10d9106788f9ef820140302de22c415 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 17:43:14 +0000 Subject: [PATCH 42/59] Update connect-redshift-postgresql-alloydb.md --- .../connect-redshift-postgresql-alloydb.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/website/docs/docs/cloud/connect-data-platform/connect-redshift-postgresql-alloydb.md b/website/docs/docs/cloud/connect-data-platform/connect-redshift-postgresql-alloydb.md index dae0ee1d178..ee5b09e83ef 100644 --- a/website/docs/docs/cloud/connect-data-platform/connect-redshift-postgresql-alloydb.md +++ b/website/docs/docs/cloud/connect-data-platform/connect-redshift-postgresql-alloydb.md @@ -64,3 +64,5 @@ The Bastion server should now be ready for dbt Cloud to use as a tunnel into the ## Configuration To learn how to optimize performance with data platform-specific configurations in dbt Cloud, refer to [Redshift-specific configuration](/reference/resource-configs/redshift-configs). + +To grant users or roles database permissions (access rights and privileges), refer to the [Redshift permissions](/reference/database-permissions/redshift-permissions) page or [Postgres permissions](/reference/database-permissions/postgres-permissions) page. From 4ec7ff6f064c11adbbce95a8e7a372e4c3a987ed Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 17:46:22 +0000 Subject: [PATCH 43/59] Update sidebars.js --- website/sidebars.js | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/website/sidebars.js b/website/sidebars.js index 6f6bf008268..1e48905f62c 100644 --- a/website/sidebars.js +++ b/website/sidebars.js @@ -936,9 +936,8 @@ const sidebarSettings = { { type: "category", label: "Database Permissions", - // link: { type: "doc", id: "reference/database-permissions/about-database-permissions" }, items: [ - "reference/database-permissions/about-database-permissions" + "reference/database-permissions/about-database-permissions", "reference/database-permissions/databricks-permissions", "reference/database-permissions/postgres-permissions", "reference/database-permissions/redshift-permissions", From 28f376d48e0e40f03f4f6cefb559a3a8a0a74773 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 17:48:51 +0000 Subject: [PATCH 44/59] Update sidebars.js From cfe13aece4cb6cec3ea7922ae592f01d32cefdf5 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 17:59:47 +0000 Subject: [PATCH 45/59] Update tableau.md adding Roxi's note --- website/docs/docs/use-dbt-semantic-layer/tableau.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/website/docs/docs/use-dbt-semantic-layer/tableau.md b/website/docs/docs/use-dbt-semantic-layer/tableau.md index ae1e4ae3bc5..108c84e318f 100644 --- a/website/docs/docs/use-dbt-semantic-layer/tableau.md +++ b/website/docs/docs/use-dbt-semantic-layer/tableau.md @@ -17,9 +17,10 @@ This integration provides a live connection to the dbt Semantic Layer through Ta ## Prerequisites 1. You must have [Tableau Desktop](https://www.tableau.com/en-gb/products/desktop) installed with version 2021.1 or greater -2. Log in to Tableau Desktop using either your license or the login details you use for Tableau Server or Tableau Online. -3. You need your dbt Cloud host, [Environment ID](/docs/use-dbt-semantic-layer/setup-sl#set-up-dbt-semantic-layer) and [service token](/docs/dbt-cloud-apis/service-tokens) to log in. This account should be set up with the dbt Semantic Layer. -4. You must have a dbt Cloud Team or Enterprise [account](https://www.getdbt.com/pricing) and multi-tenant [deployment](/docs/cloud/about-cloud/regions-ip-addresses). (Single-Tenant coming soon) + - Note that Tableau Online does not currently support custom connectors natively. +3. Log in to Tableau Desktop using either your license or the login details you use for Tableau Server or Tableau Online. +4. You need your dbt Cloud host, [Environment ID](/docs/use-dbt-semantic-layer/setup-sl#set-up-dbt-semantic-layer) and [service token](/docs/dbt-cloud-apis/service-tokens) to log in. This account should be set up with the dbt Semantic Layer. +5. You must have a dbt Cloud Team or Enterprise [account](https://www.getdbt.com/pricing) and multi-tenant [deployment](/docs/cloud/about-cloud/regions-ip-addresses). (Single-Tenant coming soon) ## Installing From ca734bd8117c4cab8ec5d72625e0aabac3e4e794 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 18:00:54 +0000 Subject: [PATCH 46/59] Update tableau.md --- website/docs/docs/use-dbt-semantic-layer/tableau.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/website/docs/docs/use-dbt-semantic-layer/tableau.md b/website/docs/docs/use-dbt-semantic-layer/tableau.md index 108c84e318f..f8772ef1d78 100644 --- a/website/docs/docs/use-dbt-semantic-layer/tableau.md +++ b/website/docs/docs/use-dbt-semantic-layer/tableau.md @@ -18,9 +18,9 @@ This integration provides a live connection to the dbt Semantic Layer through Ta 1. You must have [Tableau Desktop](https://www.tableau.com/en-gb/products/desktop) installed with version 2021.1 or greater - Note that Tableau Online does not currently support custom connectors natively. -3. Log in to Tableau Desktop using either your license or the login details you use for Tableau Server or Tableau Online. -4. You need your dbt Cloud host, [Environment ID](/docs/use-dbt-semantic-layer/setup-sl#set-up-dbt-semantic-layer) and [service token](/docs/dbt-cloud-apis/service-tokens) to log in. This account should be set up with the dbt Semantic Layer. -5. You must have a dbt Cloud Team or Enterprise [account](https://www.getdbt.com/pricing) and multi-tenant [deployment](/docs/cloud/about-cloud/regions-ip-addresses). (Single-Tenant coming soon) +2. Log in to Tableau Desktop using either your license or the login details you use for Tableau Server or Tableau Online. +3. You need your dbt Cloud host, [Environment ID](/docs/use-dbt-semantic-layer/setup-sl#set-up-dbt-semantic-layer) and [service token](/docs/dbt-cloud-apis/service-tokens) to log in. This account should be set up with the dbt Semantic Layer. +4. You must have a dbt Cloud Team or Enterprise [account](https://www.getdbt.com/pricing) and multi-tenant [deployment](/docs/cloud/about-cloud/regions-ip-addresses). (Single-Tenant coming soon) ## Installing From d7fd7d435bbdbfb386eba8df7a0e929dccb80d4e Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 18:07:18 +0000 Subject: [PATCH 47/59] Update website/docs/reference/database-permissions/snowflake-permissions.md --- .../reference/database-permissions/snowflake-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/snowflake-permissions.md b/website/docs/reference/database-permissions/snowflake-permissions.md index 637fecf09cc..962ae490e86 100644 --- a/website/docs/reference/database-permissions/snowflake-permissions.md +++ b/website/docs/reference/database-permissions/snowflake-permissions.md @@ -6,7 +6,7 @@ In Snowflake, permissions are used to control who can perform certain actions on ## Set up Snowflake account -This section will explain the exact privileges it takes to set up your Snowflake account: +This section explains how to set up permissions and roles within Snowflake. In Snowflake, you would perform these actions using SQL commands to set up your data warehouse and access control within Snowflake's ecosystem. 1. Set up databases ``` From 356c281decf8a27022bae3bb5e765ecede31f7bc Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 18:07:43 +0000 Subject: [PATCH 48/59] Update website/docs/reference/database-permissions/snowflake-permissions.md --- .../reference/database-permissions/snowflake-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/snowflake-permissions.md b/website/docs/reference/database-permissions/snowflake-permissions.md index 962ae490e86..6bc7e09ec11 100644 --- a/website/docs/reference/database-permissions/snowflake-permissions.md +++ b/website/docs/reference/database-permissions/snowflake-permissions.md @@ -6,7 +6,7 @@ In Snowflake, permissions are used to control who can perform certain actions on ## Set up Snowflake account -This section explains how to set up permissions and roles within Snowflake. In Snowflake, you would perform these actions using SQL commands to set up your data warehouse and access control within Snowflake's ecosystem. +This section explains how to set up permissions and roles within Snowflake. In Snowflake, you would perform these actions using SQL commands and set up your data warehouse and access control within Snowflake's ecosystem. 1. Set up databases ``` From a44a9c4a8716892ca0e6a682a80879b1a9ef0ca8 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 18:08:29 +0000 Subject: [PATCH 49/59] Update website/docs/reference/database-permissions/snowflake-permissions.md --- .../docs/reference/database-permissions/snowflake-permissions.md | 1 + 1 file changed, 1 insertion(+) diff --git a/website/docs/reference/database-permissions/snowflake-permissions.md b/website/docs/reference/database-permissions/snowflake-permissions.md index 6bc7e09ec11..3f474242834 100644 --- a/website/docs/reference/database-permissions/snowflake-permissions.md +++ b/website/docs/reference/database-permissions/snowflake-permissions.md @@ -50,6 +50,7 @@ grant all on warehouse reporting to role reporter; ``` 4. Create users, assigning them to their roles + Every person and application gets a separate user and is assigned to the correct role. ``` From f373cbe441ef0e7cce4fb5d9591a706c171edf8b Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 18:10:01 +0000 Subject: [PATCH 50/59] Update website/docs/reference/database-permissions/about-database-permissions.md --- .../database-permissions/about-database-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/about-database-permissions.md b/website/docs/reference/database-permissions/about-database-permissions.md index c8af3876416..5f2a1f7419c 100644 --- a/website/docs/reference/database-permissions/about-database-permissions.md +++ b/website/docs/reference/database-permissions/about-database-permissions.md @@ -10,7 +10,7 @@ pagination_prev: null Database permissions are access rights and privileges granted to users or roles within a database or data platform. They help you specify what actions users or roles can perform on various database objects, like tables, views, schemas, or even the entire database. -## Why are they useful +### Why are they useful - Database permissions are essential for security and data access control. - They ensure that only authorized users can perform specific actions. From 6768a728acd3e243d8086c9cc730ea2868d35745 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 18:10:25 +0000 Subject: [PATCH 51/59] Update about-database-permissions.md --- .../database-permissions/about-database-permissions.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/website/docs/reference/database-permissions/about-database-permissions.md b/website/docs/reference/database-permissions/about-database-permissions.md index 5f2a1f7419c..e23c5d7925b 100644 --- a/website/docs/reference/database-permissions/about-database-permissions.md +++ b/website/docs/reference/database-permissions/about-database-permissions.md @@ -17,7 +17,7 @@ Database permissions are access rights and privileges granted to users or roles - They help maintain data integrity, prevent unauthorized changes, and limit exposure to sensitive data. - Permissions also support compliance with data privacy regulations and auditing. -## How to use them +### How to use them - Users and administrators can grant and manage permissions using SQL statements or through the database system's interface. - Assign permissions to individual users or roles (groups of users) based on their responsibilities. @@ -25,9 +25,10 @@ Database permissions are access rights and privileges granted to users or roles - Users should be assigned permissions that ensure they have the necessary access to perform their tasks without overextending privileges. Something to note is that each data platform provider might have different approaches and names for privileges. Refer to their documentation for more details. -## Examples -Refer to the following database permission pages for more info on examples and how to setup database permissions: +### Examples + +Refer to the following database permission pages for more info on examples and how to set up database permissions: - [Databricks](/reference/database-permissions/databricks-permissions) - [Postgres](/reference/database-permissions/postgres-permissions) From 14aa364d9c5e1c8b270706dbb19c5dfaa48aac38 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 18:10:38 +0000 Subject: [PATCH 52/59] Update website/docs/reference/database-permissions/about-database-permissions.md --- .../database-permissions/about-database-permissions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/reference/database-permissions/about-database-permissions.md b/website/docs/reference/database-permissions/about-database-permissions.md index e23c5d7925b..76fff517646 100644 --- a/website/docs/reference/database-permissions/about-database-permissions.md +++ b/website/docs/reference/database-permissions/about-database-permissions.md @@ -19,7 +19,7 @@ Database permissions are access rights and privileges granted to users or roles ### How to use them -- Users and administrators can grant and manage permissions using SQL statements or through the database system's interface. +- Users and administrators can grant and manage permissions at various levels (such as table, schema, and so on) using SQL statements or through the database system's interface. - Assign permissions to individual users or roles (groups of users) based on their responsibilities. - Typical permissions include "SELECT" (read), "INSERT" (add data), "UPDATE" (modify data), "DELETE" (remove data), and administrative rights like "CREATE" and "DROP." - Users should be assigned permissions that ensure they have the necessary access to perform their tasks without overextending privileges. From 9f681cfa9b1a3bed4a3197dfd2ee404c8547c9df Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Wed, 1 Nov 2023 14:22:11 -0400 Subject: [PATCH 53/59] Adding sidebar config to frontmatter --- .../docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md | 1 + .../docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md | 1 + .../docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md | 1 + .../docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md | 1 + .../docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md | 1 + .../docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md | 1 + .../docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md | 1 + .../docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md | 1 + .../docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md | 1 + .../docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md | 2 +- .../core-upgrade/11-Older versions/upgrading-to-0-11-0.md | 1 + .../core-upgrade/11-Older versions/upgrading-to-0-12-0.md | 1 + .../core-upgrade/11-Older versions/upgrading-to-0-13-0.md | 1 + .../core-upgrade/11-Older versions/upgrading-to-0-14-0.md | 1 + .../core-upgrade/11-Older versions/upgrading-to-0-14-1.md | 1 + .../core-upgrade/11-Older versions/upgrading-to-0-15-0.md | 1 + .../core-upgrade/11-Older versions/upgrading-to-0-16-0.md | 1 + .../core-upgrade/11-Older versions/upgrading-to-0-17-0.md | 1 + .../core-upgrade/11-Older versions/upgrading-to-0-18-0.md | 1 + .../core-upgrade/11-Older versions/upgrading-to-0-19-0.md | 1 + 20 files changed, 20 insertions(+), 1 deletion(-) diff --git a/website/docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md b/website/docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md index e87171ffc28..6ef1243007e 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md +++ b/website/docs/docs/dbt-versions/core-upgrade/00-upgrading-to-v1.7.md @@ -2,6 +2,7 @@ title: "Upgrading to v1.7 (beta)" id: upgrading-to-v1.7 description: New features and changes in dbt Core v1.7 +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md index 2794bfd8c4d..db54073fd9f 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md +++ b/website/docs/docs/dbt-versions/core-upgrade/01-upgrading-to-v1.6.md @@ -2,6 +2,7 @@ title: "Upgrading to v1.6 (latest)" description: New features and changes in dbt Core v1.6 id: "upgrading-to-v1.6" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md b/website/docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md index 3319d19697e..038075cabcf 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md +++ b/website/docs/docs/dbt-versions/core-upgrade/02-upgrading-to-v1.5.md @@ -2,6 +2,7 @@ title: "Upgrading to v1.5" description: New features and changes in dbt Core v1.5 id: "upgrading-to-v1.5" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md b/website/docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md index faa47c49eb4..6c6d96b2326 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md +++ b/website/docs/docs/dbt-versions/core-upgrade/04-upgrading-to-v1.4.md @@ -2,6 +2,7 @@ title: "Upgrading to v1.4" description: New features and changes in dbt Core v1.4 id: "upgrading-to-v1.4" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md b/website/docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md index a3450c44561..f66d9bb9706 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md +++ b/website/docs/docs/dbt-versions/core-upgrade/05-upgrading-to-v1.3.md @@ -2,6 +2,7 @@ title: "Upgrading to v1.3" description: New features and changes in dbt Core v1.3 id: "upgrading-to-v1.3" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md b/website/docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md index 5ab98c0883b..16825ff4e2b 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md +++ b/website/docs/docs/dbt-versions/core-upgrade/06-upgrading-to-v1.2.md @@ -2,6 +2,7 @@ title: "Upgrading to v1.2" description: New features and changes in dbt Core v1.2 id: "upgrading-to-v1.2" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md b/website/docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md index 0a338923392..7819709558e 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md +++ b/website/docs/docs/dbt-versions/core-upgrade/07-upgrading-to-v1.1.md @@ -2,6 +2,7 @@ title: "Upgrading to v1.1" description: New features and changes in dbt Core v1.1 id: "upgrading-to-v1.1" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md b/website/docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md index 1da16c3ee72..7c67a1849a1 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/08-upgrading-to-v1.0.md @@ -2,6 +2,7 @@ title: "Upgrading to v1.0" description: New features and changes in dbt Core v1.0 id: "upgrading-to-v1.0" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md b/website/docs/docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md index d24ca4f6ef0..d5b429132cd 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md +++ b/website/docs/docs/dbt-versions/core-upgrade/09-upgrading-to-v0.21.md @@ -1,6 +1,7 @@ --- title: "Upgrading to v0.21" id: "upgrading-to-v0.21" +displayed_sidebar: "docs" --- diff --git a/website/docs/docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md b/website/docs/docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md index 87cb70fbe10..61a7120370a 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md +++ b/website/docs/docs/dbt-versions/core-upgrade/10-upgrading-to-v0.20.md @@ -1,7 +1,7 @@ --- title: "Upgrading to v0.20" id: "upgrading-to-v0.20" - +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-11-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-11-0.md index 567bf2d95ff..e91dde4c923 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-11-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-11-0.md @@ -1,6 +1,7 @@ --- title: "Upgrading to 0.11.0" id: "upgrading-to-0-11-0" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-12-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-12-0.md index 6df1a0d54e1..b3d4e9d9bcb 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-12-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-12-0.md @@ -1,6 +1,7 @@ --- title: "Upgrading to 0.12.0" id: "upgrading-to-0-12-0" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-13-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-13-0.md index 12c62e200fc..bb15d1a73b0 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-13-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-13-0.md @@ -1,6 +1,7 @@ --- title: "Upgrading to 0.13.0" id: "upgrading-to-0-13-0" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-0.md index 59bc87fa003..036a9a2aedf 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-0.md @@ -1,6 +1,7 @@ --- title: "Upgrading to 0.14.0" id: "upgrading-to-0-14-0" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-1.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-1.md index 457222dd9bf..215385acf0f 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-1.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-14-1.md @@ -1,6 +1,7 @@ --- title: "Upgrading to 0.14.1" id: "upgrading-to-0-14-1" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-15-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-15-0.md index 7b319c33c88..6dd2b6fb9eb 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-15-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-15-0.md @@ -1,6 +1,7 @@ --- title: "Upgrading to 0.15.0" id: "upgrading-to-0-15-0" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-16-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-16-0.md index 51d6d315dff..076e6fc4e88 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-16-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-16-0.md @@ -1,6 +1,7 @@ --- title: "Upgrading to 0.16.0" id: "upgrading-to-0-16-0" +displayed_sidebar: "docs" --- import UpgradeMove from '/snippets/_upgrade-move.md'; diff --git a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-17-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-17-0.md index 9c82730736c..5b863777df9 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-17-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-17-0.md @@ -1,6 +1,7 @@ --- title: "Upgrading to 0.17.0" id: "upgrading-to-0-17-0" +displayed_sidebar: "docs" --- diff --git a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-18-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-18-0.md index 1b1b7360836..545bfd41ac6 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-18-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-18-0.md @@ -1,5 +1,6 @@ --- title: "Upgrading to 0.18.0" +displayed_sidebar: "docs" --- diff --git a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-19-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-19-0.md index 5d0d8af04da..f408f98cc19 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-19-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-19-0.md @@ -1,5 +1,6 @@ --- title: "Upgrading to 0.19.0" +displayed_sidebar: "docs" --- From de08d520c3d9b2cdfc88c1c21e9ab4b97487281a Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Wed, 1 Nov 2023 14:26:55 -0400 Subject: [PATCH 54/59] Fixing links --- .github/pull_request_template.md | 2 +- .../2021-11-23-how-to-upgrade-dbt-versions.md | 6 +++--- .../blog/2022-08-31-august-product-update.md | 2 +- website/docs/docs/build/project-variables.md | 2 +- .../docs/docs/core/installation-overview.md | 2 +- .../11-Older versions/upgrading-to-0-19-0.md | 2 +- .../04-Sept-2023/product-docs-summer-rn.md | 2 +- .../09-April-2023/product-docs.md | 2 +- .../10-Mar-2023/1.0-deprecation.md | 2 +- .../35-dbt-cloud-changelog-2019-2020.md | 2 +- .../dbt-versions/upgrade-core-in-cloud.md | 20 +++++++++---------- .../6-foundational-structure.md | 2 +- .../migrating-from-spark-to-databricks.md | 2 +- website/snippets/core-versions-table.md | 16 +++++++-------- .../snippets/metadata-api-prerequisites.md | 2 +- 15 files changed, 33 insertions(+), 33 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 90f4938d2cb..c9b25d3b71c 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -10,7 +10,7 @@ To learn more about the writing conventions used in the dbt Labs docs, see the [ - [ ] Review the [Content style guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md) and [About versioning](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#adding-a-new-version) so my content adheres to these guidelines. - [ ] Add a checklist item for anything that needs to happen before this PR is merged, such as "needs technical review" or "change base branch." diff --git a/website/blog/2021-11-23-how-to-upgrade-dbt-versions.md b/website/blog/2021-11-23-how-to-upgrade-dbt-versions.md index 87b3ea7bd1e..69ca0b2522c 100644 --- a/website/blog/2021-11-23-how-to-upgrade-dbt-versions.md +++ b/website/blog/2021-11-23-how-to-upgrade-dbt-versions.md @@ -62,7 +62,7 @@ As noted above, the project is on 0.16.0 right now. 0.17.2 is the final patch re > > Practically, it also lets you lock in "checkpoints" of known-stable setups. If you need to pause your migration work to deal with an urgent request, you can safely deploy what you've finished so far instead of having a bunch of unrelated half-finished changes. -Review the migration guides to get an initial indication of what changes you might need to make. For example, in [the migration guide for 0.17.0](/guides/migration/versions), there are several significant changes to dbt's functionality, but it's unlikely that all of them will apply to your project. We'll cover this more later. +Review the migration guides to get an initial indication of what changes you might need to make. For example, in [the migration guide for 0.17.0](/docs/dbt-versions/core-upgrade), there are several significant changes to dbt's functionality, but it's unlikely that all of them will apply to your project. We'll cover this more later. ## Step 2: `Add require-dbt-version` to your `dbt_project.yml` file. @@ -126,9 +126,9 @@ In this case, our example project probably has dbt 0.3.0 installed. By reviewing ### Step 5b. Fix errors, then warnings -Obviously, errors that stop you from running your dbt project at all are the most important to deal with. Let's assume that our project used a too-broadly-scoped variable in a macro file, support for which was removed in v0.17. The [migration guide explains what to do instead](/guides/migration/versions), and it's a pretty straightforward fix. +Obviously, errors that stop you from running your dbt project at all are the most important to deal with. Let's assume that our project used a too-broadly-scoped variable in a macro file, support for which was removed in v0.17. The [migration guide explains what to do instead](/docs/dbt-versions/core-upgrade), and it's a pretty straightforward fix. -Once your errors are out of the way, have a look at warnings. For example, 0.17 introduced `config-version: 2` to `dbt_project.yml`. Although it's backwards compatible for now, we know that support for the old version will be removed in a future version of dbt so we might as well deal with it now. Again, the migration guide explains [what we need to do](/guides/migration/versions), and how to take full advantage of the new functionality in the future. +Once your errors are out of the way, have a look at warnings. For example, 0.17 introduced `config-version: 2` to `dbt_project.yml`. Although it's backwards compatible for now, we know that support for the old version will be removed in a future version of dbt so we might as well deal with it now. Again, the migration guide explains [what we need to do](/docs/dbt-versions/core-upgrade), and how to take full advantage of the new functionality in the future. ### Stay focused diff --git a/website/blog/2022-08-31-august-product-update.md b/website/blog/2022-08-31-august-product-update.md index cb4077f3a06..bd9d8ee0b28 100644 --- a/website/blog/2022-08-31-august-product-update.md +++ b/website/blog/2022-08-31-august-product-update.md @@ -22,7 +22,7 @@ You’ll hear more in [Tristan’s keynote](https://coalesce.getdbt.com/agenda/k ## **What's new** -- **dbt Core v1.3 beta:** Do you use Python for analytics? The first beta prerelease of dbt Core v1.3—including support for dbt models written in Python—is [ready to explore](https://docs.getdbt.com/guides/migration/versions/upgrading-to-v1.3)! Check it out, and read more about dbt supported Python models [in our docs](/docs/build/python-models). +- **dbt Core v1.3 beta:** Do you use Python for analytics? The first beta prerelease of dbt Core v1.3—including support for dbt models written in Python—is [ready to explore](https://docs.getdbt.com/docs/dbt-versions/core-upgrade/upgrading-to-v1.3)! Check it out, and read more about dbt supported Python models [in our docs](/docs/build/python-models). - **Technology Partner Program:** We just launched our new [Technology Partner Program](https://www.getdbt.com/blog/dbt-labs-technology-partner-program/) with 40+ friends in the Modern Data Stack to provide consistent support for seamless integrations joint-users can trust. Check our new [dbt Cloud integrations page](http://www.getdbt.com/product/integrations) for what’s available today! - **Single-tenant users:** dbt Cloud v1.1.60 is now available on dbt Cloud Enterprise. diff --git a/website/docs/docs/build/project-variables.md b/website/docs/docs/build/project-variables.md index 1fe45b18ac0..59d6be49b17 100644 --- a/website/docs/docs/build/project-variables.md +++ b/website/docs/docs/build/project-variables.md @@ -28,7 +28,7 @@ Jinja is not supported within the `vars` config, and all values will be interpre :::info New in v0.17.0 The syntax for specifying vars in the `dbt_project.yml` file has changed in -dbt v0.17.0. See the [migration guide](/guides/migration/versions) +dbt v0.17.0. See the [migration guide](/docs/dbt-versions/core-upgrade) for more information on these changes. ::: diff --git a/website/docs/docs/core/installation-overview.md b/website/docs/docs/core/installation-overview.md index 25628b76358..cb1df26b0f8 100644 --- a/website/docs/docs/core/installation-overview.md +++ b/website/docs/docs/core/installation-overview.md @@ -23,7 +23,7 @@ Most command-line tools, including dbt, have a `--help` flag that you can use to ## Upgrading dbt Core -dbt provides a number of resources for understanding [general best practices](/blog/upgrade-dbt-without-fear) while upgrading your dbt project as well as detailed [migration guides](/guides/migration/versions/upgrading-to-v1.4) highlighting the changes required for each minor and major release, and [core versions](/docs/dbt-versions/core) +dbt provides a number of resources for understanding [general best practices](/blog/upgrade-dbt-without-fear) while upgrading your dbt project as well as detailed [migration guides](/docs/dbt-versions/core-upgrade/upgrading-to-v1.4) highlighting the changes required for each minor and major release, and [core versions](/docs/dbt-versions/core) - [Upgrade Homebrew](/docs/core/homebrew-install#upgrading-dbt-and-your-adapter) - [Upgrade `pip`](/docs/core/pip-install#change-dbt-core-versions) diff --git a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-19-0.md b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-19-0.md index f408f98cc19..db825d8af9c 100644 --- a/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-19-0.md +++ b/website/docs/docs/dbt-versions/core-upgrade/11-Older versions/upgrading-to-0-19-0.md @@ -28,7 +28,7 @@ See the docs below for more details. We don't expect these to require action in #### Deprecations -Removed support for `config-version: 1` of dbt_project.yml, which was deprecated in v0.17.0. Use `config-version: 2` in all projects and installed packages. Otherwise, dbt will raise an error. See docs on [config-version](/reference/project-configs/config-version) and the [v0.17.0 Migration Guide](/guides/migration/versions) for details. +Removed support for `config-version: 1` of dbt_project.yml, which was deprecated in v0.17.0. Use `config-version: 2` in all projects and installed packages. Otherwise, dbt will raise an error. See docs on [config-version](/reference/project-configs/config-version) and the [v0.17.0 Migration Guide](/docs/dbt-versions/core-upgrade) for details. ### For dbt plugin maintainers diff --git a/website/docs/docs/dbt-versions/release-notes/04-Sept-2023/product-docs-summer-rn.md b/website/docs/docs/dbt-versions/release-notes/04-Sept-2023/product-docs-summer-rn.md index a647bb5f585..d8148542eef 100644 --- a/website/docs/docs/dbt-versions/release-notes/04-Sept-2023/product-docs-summer-rn.md +++ b/website/docs/docs/dbt-versions/release-notes/04-Sept-2023/product-docs-summer-rn.md @@ -35,7 +35,7 @@ You can provide feedback by opening a pull request or issue in [our repo](https: * Added a section to introduce a new beta feature [**Extended Attributes**](/docs/dbt-cloud-environments#extended-attributes-beta), which allows users to set a flexible `profiles.yml` snippet in their dbt Cloud Environment settings. ## 🎯 Core projects -* We released [dbt 1.6](/guides/migration/versions/upgrading-to-v1.6)! We added docs for the new commands `dbt retry` and `dbt clone` +* We released [dbt 1.6](/docs/dbt-versions/core-upgrade/upgrading-to-v1.6)! We added docs for the new commands `dbt retry` and `dbt clone` ## New 📚 Guides, ✏️ blog posts, and FAQs * Check out how these community members use the dbt community in the [Community spotlight](/community/spotlight). diff --git a/website/docs/docs/dbt-versions/release-notes/09-April-2023/product-docs.md b/website/docs/docs/dbt-versions/release-notes/09-April-2023/product-docs.md index d30bcf85b99..d78040ea7e4 100644 --- a/website/docs/docs/dbt-versions/release-notes/09-April-2023/product-docs.md +++ b/website/docs/docs/dbt-versions/release-notes/09-April-2023/product-docs.md @@ -26,7 +26,7 @@ Hello from the dbt Docs team: @mirnawong1, @matthewshaver, @nghi-ly, and @runleo ## 🎯 Core projects - Clearer descriptions in the [Jinja functions page](/reference/dbt-jinja-functions), that improve content for each card.  -- [1.5 Docs](/guides/migration/versions/upgrading-to-v1.5) have been released as an RC! +- [1.5 Docs](/docs/dbt-versions/core-upgrade/upgrading-to-v1.5) have been released as an RC! - See the beautiful [work captured in Core v 1.5](https://github.com/dbt-labs/docs.getdbt.com/issues?q=is%3Aissue+label%3A%22dbt-core+v1.5%22+is%3Aclosed). ## New 📚 Guides and ✏️ blog posts diff --git a/website/docs/docs/dbt-versions/release-notes/10-Mar-2023/1.0-deprecation.md b/website/docs/docs/dbt-versions/release-notes/10-Mar-2023/1.0-deprecation.md index b11bf702330..6b6f646e40e 100644 --- a/website/docs/docs/dbt-versions/release-notes/10-Mar-2023/1.0-deprecation.md +++ b/website/docs/docs/dbt-versions/release-notes/10-Mar-2023/1.0-deprecation.md @@ -17,5 +17,5 @@ Refer to some additional info and resources to help you upgrade your dbt version - [How to upgrade dbt without fear](https://docs.getdbt.com/blog/upgrade-dbt-without-fear) - [Upgrade Q&A on breaking changes](/docs/dbt-versions/upgrade-core-in-cloud#upgrading-legacy-versions-under-10) -- [Version migration guides](/guides/migration/versions) +- [Version migration guides](/docs/dbt-versions/core-upgrade) diff --git a/website/docs/docs/dbt-versions/release-notes/35-dbt-cloud-changelog-2019-2020.md b/website/docs/docs/dbt-versions/release-notes/35-dbt-cloud-changelog-2019-2020.md index b8e15b993de..a6b68cf9d51 100644 --- a/website/docs/docs/dbt-versions/release-notes/35-dbt-cloud-changelog-2019-2020.md +++ b/website/docs/docs/dbt-versions/release-notes/35-dbt-cloud-changelog-2019-2020.md @@ -197,7 +197,7 @@ initial support for a GitLab integration and self-service RBAC configuration. ## dbt Cloud v1.1.7 [September 3, 2020] This release adds a Release Candidate for [dbt -v0.18.0](/guides/migration/versions) and +v0.18.0](/docs/dbt-versions/core-upgrade) and includes bugfixes and improvements to the Cloud IDE and job scheduler. diff --git a/website/docs/docs/dbt-versions/upgrade-core-in-cloud.md b/website/docs/docs/dbt-versions/upgrade-core-in-cloud.md index d143aab5ef1..e46294029ec 100644 --- a/website/docs/docs/dbt-versions/upgrade-core-in-cloud.md +++ b/website/docs/docs/dbt-versions/upgrade-core-in-cloud.md @@ -47,7 +47,7 @@ For more on version support and future releases, see [Understanding dbt Core ver #### Need help upgrading? -If you want more advice on how to upgrade your dbt projects, check out our [migration guides](/guides/migration/versions/) and our [upgrading Q&A page](/docs/dbt-versions/upgrade-core-in-cloud#upgrading-legacy-versions-under-10). +If you want more advice on how to upgrade your dbt projects, check out our [migration guides](/docs/dbt-versions/core-upgrade/) and our [upgrading Q&A page](/docs/dbt-versions/upgrade-core-in-cloud#upgrading-legacy-versions-under-10). ## Upgrading legacy versions under 1.0 @@ -96,7 +96,7 @@ clean-targets: - Do you have custom scripts that parse dbt artifacts? - (BigQuery only) Do you use dbt's legacy capabilities around ingestion-time-partitioned tables? -If you believe your project might be affected, read more details in the migration guide [here](/guides/migration/versions/upgrading-to-v1.0). +If you believe your project might be affected, read more details in the migration guide [here](/docs/dbt-versions/core-upgrade/upgrading-to-v1.0). @@ -109,7 +109,7 @@ If you believe your project might be affected, read more details in the migratio - Do you have custom scripts that parse dbt JSON artifacts? - (Snowflake only) Do you have custom macros or materializations that depend on using transactions, such as statement blocks with `auto_begin=True`? -If you believe your project might be affected, read more details in the migration guide [here](/guides/migration/versions). +If you believe your project might be affected, read more details in the migration guide [here](/docs/dbt-versions/core-upgrade). @@ -123,7 +123,7 @@ If you believe your project might be affected, read more details in the migratio - Does your project use `adapter.dispatch` or the `spark_utils` package? - Do you have custom scripts that parse dbt JSON artifacts? -If you believe your project might be affected, read more details in the migration guide [here](/guides/migration/versions). +If you believe your project might be affected, read more details in the migration guide [here](/docs/dbt-versions/core-upgrade). @@ -146,7 +146,7 @@ See **Upgrading to v0.17.latest from v0.16** below for more details. - Do you have custom scripts that parse dbt JSON artifacts? - Do you have any custom materializations? -If you believe your project might be affected, read more details in the migration guide [here](/guides/migration/versions). +If you believe your project might be affected, read more details in the migration guide [here](/docs/dbt-versions/core-upgrade). @@ -157,7 +157,7 @@ If you believe your project might be affected, read more details in the migratio - Do you directly call `adapter_macro`? -If you believe your project might be affected, read more details in the migration guide [here](/guides/migration/versions). +If you believe your project might be affected, read more details in the migration guide [here](/docs/dbt-versions/core-upgrade). @@ -235,7 +235,7 @@ models: ``` -If you believe your project might be affected, read more details in the migration guide [here](/guides/migration/versions). +If you believe your project might be affected, read more details in the migration guide [here](/docs/dbt-versions/core-upgrade). @@ -247,7 +247,7 @@ If you believe your project might be affected, read more details in the migratio - Do you use the custom `generate_schema_name` macro? - Do you use `partition_by` config for BigQuery models? -If you believe your project might be affected, read more details in the migration guide [here](/guides/migration/versions). +If you believe your project might be affected, read more details in the migration guide [here](/docs/dbt-versions/core-upgrade). @@ -259,7 +259,7 @@ If you believe your project might be affected, read more details in the migratio - Do you have a custom materialization? - Do you have a macro that accesses `Relations` directly? -If you believe your project might be affected, read more details in the migration guide [here](/guides/migration/versions). +If you believe your project might be affected, read more details in the migration guide [here](/docs/dbt-versions/core-upgrade).
@@ -270,7 +270,7 @@ If you believe your project might be affected, read more details in the migratio - Do you use the custom `generate_schema_name` macro? - Do you use the `—non-destructive` flag? -If you believe your project might be affected, read more details in the migration guide [here](/guides/migration/versions). +If you believe your project might be affected, read more details in the migration guide [here](/docs/dbt-versions/core-upgrade).
diff --git a/website/docs/guides/dbt-ecosystem/dbt-python-snowpark/6-foundational-structure.md b/website/docs/guides/dbt-ecosystem/dbt-python-snowpark/6-foundational-structure.md index e387b208dd1..8a938e10c34 100644 --- a/website/docs/guides/dbt-ecosystem/dbt-python-snowpark/6-foundational-structure.md +++ b/website/docs/guides/dbt-ecosystem/dbt-python-snowpark/6-foundational-structure.md @@ -71,7 +71,7 @@ In this step, we’ll need to create a development branch and set up project lev - `materialized` — Tells dbt how to materialize models when compiling the code before it pushes it down to Snowflake. All models in the `marts` folder will be built as tables. - `tags` — Applies tags at a directory level to all models. All models in the `aggregates` folder will be tagged as `bi` (abbreviation for business intelligence). - `docs` — Specifies the `node_color` either by the plain color name or a hex value. -5. [Materializations](/docs/build/materializations) are strategies for persisting dbt models in a warehouse, with `tables` and `views` being the most commonly utilized types. By default, all dbt models are materialized as views and other materialization types can be configured in the `dbt_project.yml` file or in a model itself. It’s very important to note *Python models can only be materialized as tables or incremental models.* Since all our Python models exist under `marts`, the following portion of our `dbt_project.yml` ensures no errors will occur when we run our Python models. Starting with [dbt version 1.4](/guides/migration/versions/upgrading-to-v1.4#updates-to-python-models), Python files will automatically get materialized as tables even if not explicitly specified. +5. [Materializations](/docs/build/materializations) are strategies for persisting dbt models in a warehouse, with `tables` and `views` being the most commonly utilized types. By default, all dbt models are materialized as views and other materialization types can be configured in the `dbt_project.yml` file or in a model itself. It’s very important to note *Python models can only be materialized as tables or incremental models.* Since all our Python models exist under `marts`, the following portion of our `dbt_project.yml` ensures no errors will occur when we run our Python models. Starting with [dbt version 1.4](/docs/dbt-versions/core-upgrade/upgrading-to-v1.4#updates-to-python-models), Python files will automatically get materialized as tables even if not explicitly specified. ```yaml marts:     diff --git a/website/docs/guides/migration/tools/migrating-from-spark-to-databricks.md b/website/docs/guides/migration/tools/migrating-from-spark-to-databricks.md index f5549c58416..cd0577c2d96 100644 --- a/website/docs/guides/migration/tools/migrating-from-spark-to-databricks.md +++ b/website/docs/guides/migration/tools/migrating-from-spark-to-databricks.md @@ -35,7 +35,7 @@ In both dbt Core and dbt Cloud, you can migrate your projects to the Databricks- ### Prerequisites -- Your project must be compatible with dbt 1.0 or greater. Refer to [Upgrading to v1.0](/guides/migration/versions/upgrading-to-v1.0) for details. For the latest version of dbt, refer to [Upgrading to v1.3](/guides/migration/versions/upgrading-to-v1.3). +- Your project must be compatible with dbt 1.0 or greater. Refer to [Upgrading to v1.0](/docs/dbt-versions/core-upgrade/upgrading-to-v1.0) for details. For the latest version of dbt, refer to [Upgrading to v1.3](/docs/dbt-versions/core-upgrade/upgrading-to-v1.3). - For dbt Cloud, you need administrative (admin) privileges to migrate dbt projects. diff --git a/website/snippets/core-versions-table.md b/website/snippets/core-versions-table.md index b08c23c84c5..96021b24845 100644 --- a/website/snippets/core-versions-table.md +++ b/website/snippets/core-versions-table.md @@ -2,14 +2,14 @@ | dbt Core | Initial Release | Support Level | Critical Support Until | |------------------------------------------------------------|-----------------|----------------|-------------------------| -| [**v1.7**](/guides/migration/versions/upgrading-to-v1.7) (beta)| Oct 26, 2023 | - | - | -| [**v1.6**](/guides/migration/versions/upgrading-to-v1.6) | Jul 31, 2023 | Active | Jul 30, 2024 | -| [**v1.5**](/guides/migration/versions/upgrading-to-v1.5) | Apr 27, 2023 | Critical | Apr 27, 2024 | -| [**v1.4**](/guides/migration/versions/upgrading-to-v1.4) | Jan 25, 2023 | Critical | Jan 25, 2024 | -| [**v1.3**](/guides/migration/versions/upgrading-to-v1.3) | Oct 12, 2022 | End of Life* ⚠️ | Oct 12, 2023 | -| [**v1.2**](/guides/migration/versions/upgrading-to-v1.2) | Jul 26, 2022 | End of Life* ⚠️ | Jul 26, 2023 | -| [**v1.1**](/guides/migration/versions/upgrading-to-v1.1) ⚠️ | Apr 28, 2022 | Deprecated ⛔️ | Deprecated ⛔️ | -| [**v1.0**](/guides/migration/versions/upgrading-to-v1.0) ⚠️ | Dec 3, 2021 | Deprecated ⛔️ | Deprecated ⛔️ | +| [**v1.7**](/docs/dbt-versions/core-upgrade/upgrading-to-v1.7) (beta)| Oct 26, 2023 | - | - | +| [**v1.6**](/docs/dbt-versions/core-upgrade/upgrading-to-v1.6) | Jul 31, 2023 | Active | Jul 30, 2024 | +| [**v1.5**](/docs/dbt-versions/core-upgrade/upgrading-to-v1.5) | Apr 27, 2023 | Critical | Apr 27, 2024 | +| [**v1.4**](/docs/dbt-versions/core-upgrade/upgrading-to-v1.4) | Jan 25, 2023 | Critical | Jan 25, 2024 | +| [**v1.3**](/docs/dbt-versions/core-upgrade/upgrading-to-v1.3) | Oct 12, 2022 | End of Life* ⚠️ | Oct 12, 2023 | +| [**v1.2**](/docs/dbt-versions/core-upgrade/upgrading-to-v1.2) | Jul 26, 2022 | End of Life* ⚠️ | Jul 26, 2023 | +| [**v1.1**](/docs/dbt-versions/core-upgrade/upgrading-to-v1.1) ⚠️ | Apr 28, 2022 | Deprecated ⛔️ | Deprecated ⛔️ | +| [**v1.0**](/docs/dbt-versions/core-upgrade/upgrading-to-v1.0) ⚠️ | Dec 3, 2021 | Deprecated ⛔️ | Deprecated ⛔️ | | **v0.X** ⛔️ | (Various dates) | Deprecated ⛔️ | Deprecated ⛔️ | _*All versions of dbt Core since v1.0 are available in dbt Cloud until further notice. Versions that are EOL do not receive any fixes. For the best support, we recommend upgrading to a version released within the past 12 months._ ### Planned future releases diff --git a/website/snippets/metadata-api-prerequisites.md b/website/snippets/metadata-api-prerequisites.md index 35532e28bdc..6e2d1550223 100644 --- a/website/snippets/metadata-api-prerequisites.md +++ b/website/snippets/metadata-api-prerequisites.md @@ -2,5 +2,5 @@ - dbt Cloud [multi-tenant](/docs/cloud/about-cloud/tenancy#multi-tenant) or [single tenant](/docs/cloud/about-cloud/tenancy#single-tenant) account - You must be on a [Team or Enterprise plan](https://www.getdbt.com/pricing/) -- Your projects must be on dbt version 1.0 or higher. Refer to [Version migration guides](/guides/migration/versions) to upgrade +- Your projects must be on dbt version 1.0 or higher. Refer to [Version migration guides](/docs/dbt-versions/core-upgrade) to upgrade From 0790919603472398c495e0f9bff976d0e3482fad Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 18:46:49 +0000 Subject: [PATCH 55/59] Update tableau.md --- website/docs/docs/use-dbt-semantic-layer/tableau.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/use-dbt-semantic-layer/tableau.md b/website/docs/docs/use-dbt-semantic-layer/tableau.md index f8772ef1d78..c93643354aa 100644 --- a/website/docs/docs/use-dbt-semantic-layer/tableau.md +++ b/website/docs/docs/use-dbt-semantic-layer/tableau.md @@ -25,7 +25,7 @@ This integration provides a live connection to the dbt Semantic Layer through Ta ## Installing -1. Download our [connector file](https://github.com/dbt-labs/semantic-layer-tableau-connector/releases/download/v1.0.0/dbt_semantic_layer.taco) locally and add it to your default folder: +1. Download the GitHub [connector file](https://github.com/dbt-labs/semantic-layer-tableau-connector/releases/download/v1.0.2/dbt_semantic_layer.taco) locally and add it to your default folder: - Windows: `C:\Users\\[Windows User]\Documents\My Tableau Repository\Connectors` - Mac: `/Users/[user]/Documents/My Tableau Repository/Connectors` - Linux: `/opt/tableau/connectors` From 2c5aa57c438266f218c787ab35e1918f841977e4 Mon Sep 17 00:00:00 2001 From: mirnawong1 <89008547+mirnawong1@users.noreply.github.com> Date: Wed, 1 Nov 2023 18:48:04 +0000 Subject: [PATCH 56/59] Update website/docs/docs/use-dbt-semantic-layer/sl-architecture.md --- website/docs/docs/use-dbt-semantic-layer/sl-architecture.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/use-dbt-semantic-layer/sl-architecture.md b/website/docs/docs/use-dbt-semantic-layer/sl-architecture.md index 532afd16a84..152821b7e59 100644 --- a/website/docs/docs/use-dbt-semantic-layer/sl-architecture.md +++ b/website/docs/docs/use-dbt-semantic-layer/sl-architecture.md @@ -19,7 +19,7 @@ The dbt Semantic Layer allows you to define metrics and use various interfaces t The dbt Semantic Layer includes the following components: -| Components | Information | dbt Core users | dbt Cloud Developer plans | dbt Cloud Team plans | dbt Cloud Enterprise plans | License | +| Components | Information | dbt Core users | Developer plans | Team plans | Enterprise plans | License | | --- | --- | :---: | :---: | :---: | --- | | **[MetricFlow](/docs/build/about-metricflow)** | MetricFlow in dbt allows users to centrally define their semantic models and metrics with YAML specifications. | ✅ | ✅ | ✅ | ✅ | BSL package (code is source available) | | **MetricFlow Server**| A proprietary server that takes metric requests and generates optimized SQL for the specific data platform. | ❌ | ❌ | ✅ | ✅ | Proprietary, Cloud (Team & Enterprise)| From a68787d1a40e04747da0703b7617745311afaa08 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Wed, 1 Nov 2023 18:54:17 +0000 Subject: [PATCH 57/59] add rediret to current --- website/vercel.json | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/website/vercel.json b/website/vercel.json index 14b3a0a6af0..1cff8bb0e10 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -2,6 +2,11 @@ "cleanUrls": true, "trailingSlash": false, "redirects": [ + { + "source": "/reference/snowflake-permissions", + "destination": "/reference/database-permissions/snowflake-permissions", + "permanent": true + }, { "source": "/docs/build/metricflow-cli", "destination": "/docs/build/metricflow-commands", From 0426b2be31e1ddc0d8fbaf7760564266d1d6884e Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Wed, 1 Nov 2023 15:40:57 -0400 Subject: [PATCH 58/59] Updating redirects --- website/vercel.json | 100 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 100 insertions(+) diff --git a/website/vercel.json b/website/vercel.json index 1cff8bb0e10..05cad4199bb 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -2,6 +2,106 @@ "cleanUrls": true, "trailingSlash": false, "redirects": [ + { + "source": "/guides/migration/versions/upgrading-to-v1.7", + "destination": "/docs/dbt-versions/core-upgrade/upgrading-to-v1.7", + "permanent": true + }, + { + "source": "/guides/migration/versions/upgrading-to-v1.6", + "destination": "/docs/dbt-versions/core-upgrade/upgrading-to-v1.6", + "permanent": true + }, + { + "source": "/guides/migration/versions/upgrading-to-v1.5", + "destination": "/docs/dbt-versions/core-upgrade/upgrading-to-v1.5", + "permanent": true + }, + { + "source": "/guides/migration/versions/upgrading-to-v1.4", + "destination": "/docs/dbt-versions/core-upgrade/upgrading-to-v1.4", + "permanent": true + }, + { + "source": "/guides/migration/versions/upgrading-to-v1.3", + "destination": "/docs/dbt-versions/core-upgrade/upgrading-to-v1.3", + "permanent": true + }, + { + "source": "/guides/migration/versions/upgrading-to-v1.2", + "destination": "/docs/dbt-versions/core-upgrade/upgrading-to-v1.2", + "permanent": true + }, + { + "source": "/guides/migration/versions/upgrading-to-v1.1", + "destination": "/docs/dbt-versions/core-upgrade/upgrading-to-v1.1", + "permanent": true + }, + { + "source": "/guides/migration/versions/upgrading-to-v1.0", + "destination": "/docs/dbt-versions/core-upgrade/upgrading-to-v1.0", + "permanent": true + }, + { + "source": "/guides/migration/versions/upgrading-to-v0.21", + "destination": "/docs/dbt-versions/core-upgrade/upgrading-to-v0.21", + "permanent": true + }, + { + "source": "/guides/migration/versions/upgrading-to-v0.20", + "destination": "/docs/dbt-versions/core-upgrade/upgrading-to-v0.20", + "permanent": true + }, + { + "source": "/guides/migration/versions/Older%20versions/upgrading-to-0-11-0", + "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-0-11-0", + "permanent": true + }, + { + "source": "/guides/migration/versions/Older%20versions/upgrading-to-0-12-0", + "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-0-12-0", + "permanent": true + }, + { + "source": "/guides/migration/versions/Older%20versions/upgrading-to-0-13-0", + "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-0-13-0", + "permanent": true + }, + { + "source": "/guides/migration/versions/Older%20versions/upgrading-to-0-14-0", + "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-0-14-0", + "permanent": true + }, + { + "source": "/guides/migration/versions/Older%20versions/upgrading-to-0-14-1", + "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-0-14-1", + "permanent": true + }, + { + "source": "/guides/migration/versions/Older%20versions/upgrading-to-0-15-0", + "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-0-15-0", + "permanent": true + }, + { + "source": "/guides/migration/versions/Older%20versions/upgrading-to-0-16-0", + "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-0-16-0", + "permanent": true + }, + { + "source": "/guides/migration/versions/Older%20versions/upgrading-to-0-17-0", + "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-0-17-0", + "permanent": true + }, + { + "source": "/guides/migration/versions/Older%20versions/upgrading-to-0-18-0", + "destination":"/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-0-18-0" , + "permanent": true + }, + { + "source": "/guides/migration/versions/Older%20versions/upgrading-to-0-19-0", + "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-0-19-0", + "permanent": true + }, { "source": "/reference/snowflake-permissions", "destination": "/reference/database-permissions/snowflake-permissions", From cb18bd371f80d5aaf0530cc868d8eee101d17ac4 Mon Sep 17 00:00:00 2001 From: "Leona B. Campbell" <3880403+runleonarun@users.noreply.github.com> Date: Wed, 1 Nov 2023 16:25:17 -0700 Subject: [PATCH 59/59] Update vercel.json (#4388) We missed a redirect when we merged [this PR ](https://github.com/dbt-labs/docs.getdbt.com/pull/4372/files#diff-21378a71578c160a16aa86a2ccc6120c09d1d10a3deaf16af651a228bd0cfde4) --- website/vercel.json | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/website/vercel.json b/website/vercel.json index 05cad4199bb..81d955e2d3d 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -2,6 +2,11 @@ "cleanUrls": true, "trailingSlash": false, "redirects": [ + { + "source": "/guides/migration/versions", + "destination": "/docs/dbt-versions/core-upgrade", + "permanent": true + }, { "source": "/guides/migration/versions/upgrading-to-v1.7", "destination": "/docs/dbt-versions/core-upgrade/upgrading-to-v1.7",