From 2a4ad69726e1be2f6ca7b678ca1b375deae876d4 Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Thu, 12 Sep 2024 13:44:02 +0100 Subject: [PATCH 1/5] update faq --- .../Troubleshooting/access_token_error.md | 21 ------------------- .../Troubleshooting/auth-expired-error.md | 19 +++++++++++++++++ website/vercel.json | 5 +++++ 3 files changed, 24 insertions(+), 21 deletions(-) delete mode 100644 website/docs/faqs/Troubleshooting/access_token_error.md create mode 100644 website/docs/faqs/Troubleshooting/auth-expired-error.md diff --git a/website/docs/faqs/Troubleshooting/access_token_error.md b/website/docs/faqs/Troubleshooting/access_token_error.md deleted file mode 100644 index db59d3ba17a..00000000000 --- a/website/docs/faqs/Troubleshooting/access_token_error.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -title: I'm receiving an `access_token` error when trying to run queries in the IDE. -description: "Reauthenticate warehouse when seeing `access_token` error" -sidebar_label: 'Receiving `access_token` error in the IDE' -id: access_token_error - ---- - -If you're seeing a database error labeled `access_token` when you try to run queries in the IDE, this means your [OAuth](/docs/cloud/manage-access/set-up-snowflake-oauth) connection between Snowflake and dbt Cloud has expired. - -To fix this, you'll need to re-connect the two tools. - -Your Snowflake administrator can [configure](/docs/cloud/manage-access/set-up-snowflake-oauth#create-a-security-integration) the refresh tokens' validity, which has a maximum 90-day validity period. - -To resolve the issue, complete the following steps: - -1. Go to your **Profile settings** page (accessible from the gear icon at the upper right corner of dbt Cloud). -2. Click on the correct warehouse connection under **Credentials**. -3. Click the green **Reconnect Snowflake Account** button in the **Development Credentials** section. This drives you through reauthentication through the SSO flow. - -If you've tried the step above and are still experiencing this behavior, reach out to the Support team at support@getdbt.com for further assistance. diff --git a/website/docs/faqs/Troubleshooting/auth-expired-error.md b/website/docs/faqs/Troubleshooting/auth-expired-error.md new file mode 100644 index 00000000000..510ee8e9bf9 --- /dev/null +++ b/website/docs/faqs/Troubleshooting/auth-expired-error.md @@ -0,0 +1,19 @@ +--- +title: Receiving an `authentication has expired` error when trying to run queries in the IDE. +description: "Reauthenticate warehouse when seeing `authentication has expired` error" +sidebar_label: 'Receiving `authentication has expired` error in the IDE' +--- + +If you see a `authentication has expired` error when you try to run queries in the dbt CLoud IDE, this means your [OAuth](/docs/cloud/manage-access/set-up-snowflake-oauth) connection between Snowflake and dbt Cloud has expired. + +To fix this, you'll need to re-connect the two tools. + +Your Snowflake administrator can [configure](/docs/cloud/manage-access/set-up-snowflake-oauth#create-a-security-integration) the refresh tokens' validity, which has a maximum 90-day validity period. + +To resolve the issue, complete the following steps: + +1. Go to your **Profile settings** page, accessible from the navigation menu. +2. Navigate to **Credentials** and click on the project you're experiencing the issue with. +3. Under **Development credentials**, click the green **Reconnect Snowflake Account** button. This drives you through reauthentication through the SSO workflow. + +If you've tried these step and are still experiencing this behavior, reach out to the Support team at support@getdbt.com for further assistance. diff --git a/website/vercel.json b/website/vercel.json index f79fc959187..defdc449276 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -2,6 +2,11 @@ "cleanUrls": true, "trailingSlash": false, "redirects": [ + { + "source": "/faqs/Troubleshooting/access_token_error", + "destination": "/faqs/Troubleshooting/auth-expired-error", + "permanent": true + }, { "source": "/faqs/Models/unique-model-names", "destination": "/faqs/Project/unique-resource-names", From 1ea499a62d06994fa348dc24eaa11c9316fde75b Mon Sep 17 00:00:00 2001 From: mirnawong1 Date: Thu, 12 Sep 2024 14:17:15 +0100 Subject: [PATCH 2/5] update faq --- website/docs/guides/debug-errors.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/debug-errors.md b/website/docs/guides/debug-errors.md index 58776fa181f..442284fc6ee 100644 --- a/website/docs/guides/debug-errors.md +++ b/website/docs/guides/debug-errors.md @@ -395,7 +395,7 @@ If you just opened a SQL file in the `target/` directory to help debug an issue, Here are some useful FAQs to help you debug your dbt project: - -- +- - - - From fcbc0b60915ac819918411b8286c3db5cad5cbde Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 13 Sep 2024 09:54:55 +0100 Subject: [PATCH 3/5] Update website/docs/faqs/Troubleshooting/auth-expired-error.md Co-authored-by: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> --- website/docs/faqs/Troubleshooting/auth-expired-error.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/faqs/Troubleshooting/auth-expired-error.md b/website/docs/faqs/Troubleshooting/auth-expired-error.md index 510ee8e9bf9..024fb6baa78 100644 --- a/website/docs/faqs/Troubleshooting/auth-expired-error.md +++ b/website/docs/faqs/Troubleshooting/auth-expired-error.md @@ -6,7 +6,7 @@ sidebar_label: 'Receiving `authentication has expired` error in the IDE' If you see a `authentication has expired` error when you try to run queries in the dbt CLoud IDE, this means your [OAuth](/docs/cloud/manage-access/set-up-snowflake-oauth) connection between Snowflake and dbt Cloud has expired. -To fix this, you'll need to re-connect the two tools. +To fix this, you must reconnect the two tools. Your Snowflake administrator can [configure](/docs/cloud/manage-access/set-up-snowflake-oauth#create-a-security-integration) the refresh tokens' validity, which has a maximum 90-day validity period. From 53e39d1e4bc0b090214fb7f58aacfbcd2f5203c4 Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 13 Sep 2024 09:55:15 +0100 Subject: [PATCH 4/5] Update website/docs/faqs/Troubleshooting/auth-expired-error.md Co-authored-by: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> --- website/docs/faqs/Troubleshooting/auth-expired-error.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/faqs/Troubleshooting/auth-expired-error.md b/website/docs/faqs/Troubleshooting/auth-expired-error.md index 024fb6baa78..80f7fe11b77 100644 --- a/website/docs/faqs/Troubleshooting/auth-expired-error.md +++ b/website/docs/faqs/Troubleshooting/auth-expired-error.md @@ -14,6 +14,6 @@ To resolve the issue, complete the following steps: 1. Go to your **Profile settings** page, accessible from the navigation menu. 2. Navigate to **Credentials** and click on the project you're experiencing the issue with. -3. Under **Development credentials**, click the green **Reconnect Snowflake Account** button. This drives you through reauthentication through the SSO workflow. +3. Under **Development credentials**, click the **Reconnect Snowflake Account** (green) button. This steps you through reauthentication using the SSO workflow. If you've tried these step and are still experiencing this behavior, reach out to the Support team at support@getdbt.com for further assistance. From 91d85b69525cc5587bc3cbf96b838b3d1aa08043 Mon Sep 17 00:00:00 2001 From: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> Date: Fri, 13 Sep 2024 09:55:30 +0100 Subject: [PATCH 5/5] Update website/docs/faqs/Troubleshooting/auth-expired-error.md Co-authored-by: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> --- website/docs/faqs/Troubleshooting/auth-expired-error.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/faqs/Troubleshooting/auth-expired-error.md b/website/docs/faqs/Troubleshooting/auth-expired-error.md index 80f7fe11b77..267407a8c70 100644 --- a/website/docs/faqs/Troubleshooting/auth-expired-error.md +++ b/website/docs/faqs/Troubleshooting/auth-expired-error.md @@ -16,4 +16,4 @@ To resolve the issue, complete the following steps: 2. Navigate to **Credentials** and click on the project you're experiencing the issue with. 3. Under **Development credentials**, click the **Reconnect Snowflake Account** (green) button. This steps you through reauthentication using the SSO workflow. -If you've tried these step and are still experiencing this behavior, reach out to the Support team at support@getdbt.com for further assistance. +If you've tried these step and are still getting this error, please contact the Support team at support@getdbt.com for further assistance.