Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding Unit testing docs and reference page #4603

Merged
merged 94 commits into from
Feb 14, 2024
Merged
Show file tree
Hide file tree
Changes from 9 commits
Commits
Show all changes
94 commits
Select commit Hold shift + click to select a range
61fdb9c
Adding multi cell
matthewshaver Dec 1, 2023
2e1aa1a
Updating links to access
matthewshaver Dec 1, 2023
b242461
Adding reference page for unit tests
matthewshaver Dec 6, 2023
840eed4
Unit tests
matthewshaver Dec 6, 2023
3dd2aad
Merge branch 'current' into next
matthewshaver Dec 11, 2023
6ce45ff
Update website/docs/reference/resource-properties/unit-tests.md
matthewshaver Jan 9, 2024
47d2827
Merge branch 'next' into unit-testing
matthewshaver Jan 9, 2024
214eb6f
Update website/dbt-versions.js
matthewshaver Jan 9, 2024
12fbe42
Fixing spacing changes
matthewshaver Jan 9, 2024
8eee934
Update website/docs/reference/resource-properties/unit-tests.md
matthewshaver Jan 10, 2024
a790962
Update website/docs/reference/resource-properties/unit-tests.md
matthewshaver Jan 10, 2024
b6d8ed6
Update website/docs/reference/resource-properties/unit-tests.md
matthewshaver Feb 7, 2024
9772609
Adding /docs page for unit tests
matthewshaver Feb 7, 2024
19fd463
fixing spacing on YML
matthewshaver Feb 7, 2024
f044ff1
Update unit-tests.md
matthewshaver Feb 7, 2024
56db5ca
Update unit-tests.md
matthewshaver Feb 7, 2024
6112e01
Update unit-tests.md
matthewshaver Feb 7, 2024
1687dd3
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 9, 2024
a18b387
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 9, 2024
5ffa00b
Updates
matthewshaver Feb 9, 2024
2329f3f
Updates from feedback
matthewshaver Feb 9, 2024
02e057b
Updates
matthewshaver Feb 9, 2024
d1e46f0
Merge branch 'current' into unit-testing
matthewshaver Feb 9, 2024
829c40c
Reverting changes
matthewshaver Feb 9, 2024
7547ecb
fixing edits
matthewshaver Feb 9, 2024
ada5919
fixing
matthewshaver Feb 9, 2024
59cbb84
fixing
matthewshaver Feb 9, 2024
4fb38a2
Updating sidebar folders
matthewshaver Feb 9, 2024
6fe72ff
Fixing errors
matthewshaver Feb 9, 2024
d621b2b
Update unit-tests.md
matthewshaver Feb 9, 2024
b6376c1
fixing yet another merge error
matthewshaver Feb 9, 2024
b0a3ba7
Merge branch 'unit-testing' of https://github.com/dbt-labs/docs.getdb…
matthewshaver Feb 9, 2024
688aede
Update unit-tests.md
matthewshaver Feb 9, 2024
80ec818
Update unit-tests.md
matthewshaver Feb 9, 2024
ed9e312
Updating based on feedback
matthewshaver Feb 9, 2024
0cf9022
Merge branch 'unit-testing' of https://github.com/dbt-labs/docs.getdb…
matthewshaver Feb 9, 2024
420e2f1
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 9, 2024
75ca6f5
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 9, 2024
4281976
Update unit-tests.md
matthewshaver Feb 9, 2024
9dbb79a
Update unit-tests.md
matthewshaver Feb 9, 2024
0de14e7
Apply suggestions from code review
dbeatty10 Feb 10, 2024
b94fb0a
Apply suggestions from code review
matthewshaver Feb 10, 2024
353c4f3
Update unit-tests.md
matthewshaver Feb 10, 2024
5bfff10
updating spacing
matthewshaver Feb 10, 2024
37df470
Update website/docs/reference/resource-properties/unit-tests.md
runleonarun Feb 10, 2024
39b83aa
Update website/docs/reference/commands/test.md
matthewshaver Feb 10, 2024
90526f6
Update website/docs/reference/resource-properties/unit-tests.md
runleonarun Feb 10, 2024
e213f47
Merge branch 'current' into unit-testing
runleonarun Feb 10, 2024
ab28f99
Apply suggestions from code review
matthewshaver Feb 10, 2024
f5753a7
Update website/docs/docs/build/unit-tests.md
runleonarun Feb 10, 2024
3872aaa
Update website/docs/docs/build/unit-tests.md
runleonarun Feb 10, 2024
567ef15
Update website/docs/docs/build/unit-tests.md
runleonarun Feb 10, 2024
57cbfe1
Update unit-tests.md
matthewshaver Feb 10, 2024
1a7d70d
Apply suggestions from code review
matthewshaver Feb 10, 2024
0d6b78a
Update unit-tests.md
matthewshaver Feb 10, 2024
5c50489
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 13, 2024
92b55c0
Update website/docs/reference/resource-properties/unit-tests.md
matthewshaver Feb 13, 2024
810180d
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 13, 2024
225f48f
Update website/docs/reference/resource-properties/unit-tests.md
matthewshaver Feb 13, 2024
ea79e05
Update unit-tests.md
matthewshaver Feb 13, 2024
fc0ba3a
Update unit-tests.md
matthewshaver Feb 13, 2024
fb45528
Update unit-tests.md
matthewshaver Feb 13, 2024
c0aa1d2
Merge branch 'current' into unit-testing
matthewshaver Feb 13, 2024
2edec42
Update website/sidebars.js
matthewshaver Feb 13, 2024
158ea89
Update unit-tests.md
matthewshaver Feb 13, 2024
8b4b31b
Update unit-tests.md
matthewshaver Feb 13, 2024
0a91b5e
Merge branch 'current' into unit-testing
runleonarun Feb 13, 2024
27ecde3
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
fba1903
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
bdfc000
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
58c41a6
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
f67b779
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
db435da
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
97f7e7a
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
62ce8c6
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
8bd64f7
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
72b84f2
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
dbd0aa4
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
12f92a8
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
dd87c90
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
694037a
Update unit-tests.md
matthewshaver Feb 14, 2024
528e653
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
5870f96
Update website/docs/reference/resource-properties/unit-tests.md
matthewshaver Feb 14, 2024
c10ea49
Update website/docs/reference/resource-properties/unit-tests.md
matthewshaver Feb 14, 2024
95cd74b
Update website/docs/reference/resource-properties/unit-tests.md
matthewshaver Feb 14, 2024
7b3f23b
Update website/docs/reference/resource-properties/unit-tests.md
matthewshaver Feb 14, 2024
ef9ceee
Update website/docs/reference/resource-properties/unit-tests.md
matthewshaver Feb 14, 2024
d6b4fa1
Apply suggestions from code review
matthewshaver Feb 14, 2024
8503acd
Apply suggestions from code review
matthewshaver Feb 14, 2024
a1b3614
Update website/docs/docs/build/unit-tests.md
matthewshaver Feb 14, 2024
ba74fe5
Apply suggestions from code review
graciegoheen Feb 14, 2024
9c626b9
Fixing format and spacing
matthewshaver Feb 14, 2024
6b8e034
fixing links
matthewshaver Feb 14, 2024
11fc966
Merge branch 'current' into unit-testing
matthewshaver Feb 14, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions contributing/content-style-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -544,14 +544,14 @@ The file or URL paths begin with:
- /reference/
- /community/

Let's use the Regions & IP Addresses URL as an example: https://docs.getdbt.com/docs/cloud/about-cloud/regions-ip-addresses
Let's use the Regions & IP Addresses URL as an example: https://docs.getdbt.com/docs/cloud/about-cloud/access-regions-ip-addresses
If we need to reference this on another page, we can remove the domain entirely:

`For more information about server availability, please refer to our [Regions & IP Addresses page](/docs/cloud/about-cloud/regions-ip-addresses)`
`For more information about server availability, please refer to our [Regions & IP Addresses page](/docs/cloud/about-cloud/access-regions-ip-addresses)`

The reader will see:

For more information about server availability, please refer to our [Regions & IP Addresses page](/docs/cloud/about-cloud/regions-ip-addresses)
For more information about server availability, please refer to our [Regions & IP Addresses page](/docs/cloud/about-cloud/access-regions-ip-addresses)

You can link to a specific section of the doc with a `#` at the end of the path. Enter the section’s title after the `#`, with individual words separated by hyphens. Let's use the incremental models page, https://docs.getdbt.com/docs/build/incremental-models, as an example:

Expand Down
2 changes: 1 addition & 1 deletion website/docs/docs/build/metrics.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ The dbt Semantic Layer has undergone a [significant revamp](https://www.getdbt.c
The dbt_metrics package has been [deprecated](https://docs.getdbt.com/blog/deprecating-dbt-metrics) and replaced with [MetricFlow](/docs/build/about-metricflow?version=1.6), a new framework for defining metrics in dbt. This means dbt_metrics is no longer supported after dbt v1.5 and won't receive any code fixes. We will also remove the dbt_metrics spec and docs when it's fully deprecated.

**Who does this affect?** <br /> <br />
Anyone who uses the dbt_metrics package or is integrated with the legacy Semantic Layer. The new Semantic Layer is available to [Team or Enterprise](https://www.getdbt.com/pricing/) multi-tenant dbt Cloud plans [hosted in North America](/docs/cloud/about-cloud/regions-ip-addresses). You must be on dbt v1.6 or higher to access it. All users can define metrics using MetricFlow. Users on dbt Cloud Developer plans or dbt Core can only use it to define and test metrics locally, but can't dynamically query them with integrated tools.
Anyone who uses the dbt_metrics package or is integrated with the legacy Semantic Layer. The new Semantic Layer is available to [Team or Enterprise](https://www.getdbt.com/pricing/) multi-tenant dbt Cloud plans [hosted in North America](/docs/cloud/about-cloud/access-regions-ip-addresses). You must be on dbt v1.6 or higher to access it. All users can define metrics using MetricFlow. Users on dbt Cloud Developer plans or dbt Core can only use it to define and test metrics locally, but can't dynamically query them with integrated tools.

**What should you do?** <br /> <br />
If you've defined metrics using dbt_metrics or integrated with the legacy Semantic Layer, we **highly** recommend you [upgrade your dbt version](/docs/dbt-versions/upgrade-core-in-cloud) to dbt v1.6 or higher to use MetricFlow or the new dbt Semantic Layer. To migrate to the new Semantic Layer, refer to the dedicated [migration guide](/guides/sl-migration) for more info.
Expand Down
17 changes: 15 additions & 2 deletions website/docs/docs/cloud/about-cloud/regions-ip-addresses.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: "Regions & IP addresses"
id: "regions-ip-addresses"
title: "Access, Regions, & IP addresses"
sidebar: "Access, Regions, & IP Addresses"
id: "access-regions-ip-addresses"
description: "Available regions and ip addresses"
---

Expand All @@ -20,6 +21,18 @@ dbt Cloud is [hosted](/docs/cloud/about-cloud/architecture) in multiple regions

[^1]: These regions support [multi-tenant](/docs/cloud/about-cloud/tenancy) deployment environments hosted by dbt Labs.

## Accessing your account

To login to dbt Cloud, use the URL that applies to your environment. Your access URL used will depend on a few factors including location and tenancy:
- **US multi-tenant:** Use your unique URL that starts with your account prefix, followed by `us1.dbt.com`. For example, `abc123.us1.dbt.com`.
- If you are unsure of your access URL, navigate to `us1.dbt.com` and enter your credentials. If you are a member of a single account, you will be logged in and your URL will be displayed in the browser. If you are a member of muliple accounts, you will be presented with a list of options, along with the appropriate login URLs for each

<Lightbox src="/img/docs/dbt-cloud/find-account.png" title="dbt Cloud accounts" />

- **EMEA multi-tenant:** Use the URL `emea.dbt.com`.
- **APAC multi-tenant:** Use the URL `au.dbt.com`.
- **Worldwide single-tenant and VPC:** Use the vanity URL provided during your onboarding.

### Locating your dbt Cloud IP addresses

There are two ways to view your dbt Cloud IP addresses:
Expand Down
2 changes: 1 addition & 1 deletion website/docs/docs/cloud/billing.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ pagination_next: null
pagination_prev: null
---

dbt Cloud offers a variety of [plans and pricing](https://www.getdbt.com/pricing/) to fit your organization’s needs. With flexible billing options that appeal to large enterprises and small businesses and [server availability](/docs/cloud/about-cloud/regions-ip-addresses) worldwide, dbt Cloud is the fastest and easiest way to begin transforming your data.
dbt Cloud offers a variety of [plans and pricing](https://www.getdbt.com/pricing/) to fit your organization’s needs. With flexible billing options that appeal to large enterprises and small businesses and [server availability](/docs/cloud/about-cloud/access-regions-ip-addresses) worldwide, dbt Cloud is the fastest and easiest way to begin transforming your data.

## How does dbt Cloud pricing work?

Expand Down
2 changes: 1 addition & 1 deletion website/docs/docs/cloud/cloud-cli-installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ dbt commands are run against dbt Cloud's infrastructure and benefit from:


## Prerequisites
The dbt Cloud CLI is available in all [deployment regions](/docs/cloud/about-cloud/regions-ip-addresses) and for both multi-tenant and single-tenant accounts (Azure single-tenant not supported at this time).
The dbt Cloud CLI is available in all [deployment regions](/docs/cloud/about-cloud/access-regions-ip-addresses) and for both multi-tenant and single-tenant accounts (Azure single-tenant not supported at this time).

- Ensure you are using dbt version 1.5 or higher. Refer to [dbt Cloud versions](/docs/dbt-versions/upgrade-core-in-cloud) to upgrade.
- Note that SSH tunneling for [Postgres and Redshift](/docs/cloud/connect-data-platform/connect-redshift-postgresql-alloydb) connections doesn't support the dbt Cloud CLI yet.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ These connection instructions provide the basic fields required for configuring

## IP Restrictions

dbt Cloud will always connect to your data platform from the IP addresses specified in the [Regions & IP addresses](/docs/cloud/about-cloud/regions-ip-addresses) page.
dbt Cloud will always connect to your data platform from the IP addresses specified in the [Regions & IP addresses](/docs/cloud/about-cloud/access-regions-ip-addresses) page.

Be sure to allow traffic from these IPs in your firewall, and include them in any database grants.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ Make sure the location of the instance is the same Virtual Private Cloud (VPC) a

To configure the SSH tunnel in dbt Cloud, you'll need to provide the hostname/IP of your bastion server, username, and port, of your choosing, that dbt Cloud will connect to. Review the following steps:

- Verify the bastion server has its network security rules set up to accept connections from the [dbt Cloud IP addresses](/docs/cloud/about-cloud/regions-ip-addresses) on whatever port you configured.
- Verify the bastion server has its network security rules set up to accept connections from the [dbt Cloud IP addresses](/docs/cloud/about-cloud/access-regions-ip-addresses) on whatever port you configured.
- Set up the user account by using the bastion servers instance's CLI, The following example uses the username `dbtcloud:`

```shell
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@ The IDE uses developer credentials to connect to your data platform. These devel

Set up your developer credentials:

1. Navigate to your **Credentials** under **Your Profile** settings, which you can access at `https://YOUR_ACCESS_URL/settings/profile#credentials`, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/regions-ip-addresses) for your region and plan.
1. Navigate to your **Credentials** under **Your Profile** settings, which you can access at `https://YOUR_ACCESS_URL/settings/profile#credentials`, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/access-regions-ip-addresses) for your region and plan.
2. Select the relevant project in the list.
3. Click **Edit** on the bottom right of the page.
4. Enter the details under **Development Credentials**.
Expand Down
2 changes: 1 addition & 1 deletion website/docs/docs/cloud/git/connect-gitlab.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ In GitLab, when creating your Group Application, input the following:
| **Confidential** | ✔️ |
| **Scopes** | ✔️ api |

Replace `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/regions-ip-addresses) for your region and plan.
Replace `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/access-regions-ip-addresses) for your region and plan.

The application form in GitLab should look as follows when completed:

Expand Down
4 changes: 2 additions & 2 deletions website/docs/docs/cloud/git/setup-azure.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Once the Azure AD app is added to dbt Cloud and the service user is connected, t
4. Provide a name for your app. We recommend using, "dbt Labs Azure DevOps App".
5. Select **Accounts in any organizational directory (Any Azure AD directory - Multitenant)** as the Supported Account Types.
Many customers ask why they need to select Multitenant instead of Single tenant, and they frequently get this step wrong. Microsoft considers Azure DevOps (formerly called Visual Studio) and Azure Active Directory as separate tenants, and in order for this Active Directory application to work properly, you must select Multitenant.
6. Add a redirect URI by selecting **Web** and, in the field, entering `https://YOUR_ACCESS_URL/complete/azure_active_directory`, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/regions-ip-addresses) for your region and plan.
6. Add a redirect URI by selecting **Web** and, in the field, entering `https://YOUR_ACCESS_URL/complete/azure_active_directory`, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/access-regions-ip-addresses) for your region and plan.
7. Click **Register**.

<Lightbox src="/img/docs/dbt-cloud/connecting-azure-devops/ADnavigation.gif" title="Navigating to the Azure AD app registrations"/>
Expand Down Expand Up @@ -59,7 +59,7 @@ You also need to add another redirect URI to your Azure AD application. This red

1. Navigate to your Azure AD application.
2. Select the link next to **Redirect URIs**
3. Click **Add URI** and add the URI, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/regions-ip-addresses) for your region and plan:
3. Click **Add URI** and add the URI, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/access-regions-ip-addresses) for your region and plan:
`https://YOUR_ACCESS_URL/complete/azure_active_directory_service_user`
4. Click **Save**.

Expand Down
2 changes: 1 addition & 1 deletion website/docs/docs/cloud/manage-access/invite-users.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ You must have proper permissions to invite new users:

## User experience

dbt Cloud generates and sends emails from `[email protected]` to the specified addresses. Make sure traffic from the `[email protected]` email is allowed in your settings to avoid emails from going to spam or being blocked. This is the originating email address for all [instances worldwide](/docs/cloud/about-cloud/regions-ip-addresses).
dbt Cloud generates and sends emails from `[email protected]` to the specified addresses. Make sure traffic from the `[email protected]` email is allowed in your settings to avoid emails from going to spam or being blocked. This is the originating email address for all [instances worldwide](/docs/cloud/about-cloud/access-regions-ip-addresses).


The email contains a link to create an account. When the user clicks on this they will be brought to one of two screens depending on whether SSO is configured or not.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ On the **Credentials** page, you can see your existing keys, client IDs, and ser

Set up an [OAuth consent screen](https://support.google.com/cloud/answer/6158849) if you haven't already. Then, click **+ Create Credentials** at the top of the page and select **OAuth client ID**.

Fill in the application, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/regions-ip-addresses) for your region and plan:
Fill in the application, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/access-regions-ip-addresses) for your region and plan:

| Config | Value |
| ------ | ----- |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ These parameters and descriptions will help you authenticate with your username
| **USERNAME** | Your Databricks username (account admin level) |
| **PASSWORD** | Your Databricks password (account admin level) |
| **ACCOUNT_ID** | Your Databricks [account ID](https://docs.databricks.com/en/administration-guide/account-settings/index.html#locate-your-account-id) |
| **YOUR_ACCESS_URL** | The [appropriate Access URL](/docs/cloud/about-cloud/regions-ip-addresses) for your dbt Cloud account region and plan |
| **YOUR_ACCESS_URL** | The [appropriate Access URL](/docs/cloud/about-cloud/access-regions-ip-addresses) for your dbt Cloud account region and plan |
| **NAME** | The integration name (i.e 'databricks-dbt-cloud')

After running the `curl`, you'll get an API response that includes the `client_id` and `client_secret` required in the following section. At this time, this is the only way to retrieve the secret. If you lose the secret, then the integration needs to be [deleted](https://docs.databricks.com/api/account/customappintegration/delete) and re-created.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ To enable Snowflake OAuth, you will need to create a [security integration](http

### Create a security integration

In Snowflake, execute a query to create a security integration. Please find the complete documentation on creating a security integration for custom clients [here](https://docs.snowflake.net/manuals/sql-reference/sql/create-security-integration.html#syntax). In the following example `create or replace security integration` query, replace `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/regions-ip-addresses) for your region and plan.
In Snowflake, execute a query to create a security integration. Please find the complete documentation on creating a security integration for custom clients [here](https://docs.snowflake.net/manuals/sql-reference/sql/create-security-integration.html#syntax). In the following example `create or replace security integration` query, replace `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/access-regions-ip-addresses) for your region and plan.

```
CREATE OR REPLACE SECURITY INTEGRATION DBT_CLOUD
Expand All @@ -42,7 +42,7 @@ CREATE OR REPLACE SECURITY INTEGRATION DBT_CLOUD
| ENABLED | Required |
| OAUTH_CLIENT | Required |
| OAUTH_CLIENT_TYPE | Required |
| OAUTH_REDIRECT_URI | Required. Use the access URL that corresponds to your server [region](/docs/cloud/about-cloud/regions-ip-addresses). If dbt Cloud is deployed on-premises, use the domain name of your application instead of the access URL. |
| OAUTH_REDIRECT_URI | Required. Use the access URL that corresponds to your server [region](/docs/cloud/about-cloud/access-regions-ip-addresses). If dbt Cloud is deployed on-premises, use the domain name of your application instead of the access URL. |
| OAUTH_ISSUE_REFRESH_TOKENS | Required |
| OAUTH_REFRESH_TOKEN_VALIDITY | Required. This configuration dictates the number of seconds that a refresh token is valid for. Use a smaller value to force users to re-authenticate with Snowflake more frequently. |

Expand Down Expand Up @@ -103,7 +103,7 @@ This error might be because of a configuration issue in the Snowflake OAuth flow
* In the Snowflake OAuth flow, `role` in the profile config is not optional, as it does not inherit from the project connection config. So each user must supply their role, regardless of whether it is provided in the project connection.

#### Server error 500
If you experience a 500 server error when redirected from Snowflake to dbt Cloud, double-check that you have allow listed [dbt Cloud's IP addresses](/docs/cloud/about-cloud/regions-ip-addresses) on a Snowflake account level.
If you experience a 500 server error when redirected from Snowflake to dbt Cloud, double-check that you have allow listed [dbt Cloud's IP addresses](/docs/cloud/about-cloud/access-regions-ip-addresses) on a Snowflake account level.

Enterprise customers who have single-tenant deployments will have a different range of IP addresses (network CIDR ranges) to allow list.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ Settings.
account using GSuite auth. Optionally, you may specify a CSV of domains
which are _all_ authorized to access your dbt Cloud account (eg. `dbtlabs.com, fishtowndata.com`)
- **Slug**: Enter your desired login slug. Users will be able to log into dbt
Cloud by navigating to `https://YOUR_ACCESS_URL/enterprise-login/LOGIN-SLUG`, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/regions-ip-addresses) for your region and plan. The `LOGIN-SLUG` must
Cloud by navigating to `https://YOUR_ACCESS_URL/enterprise-login/LOGIN-SLUG`, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/access-regions-ip-addresses) for your region and plan. The `LOGIN-SLUG` must
be unique across all dbt Cloud accounts, so pick a slug that uniquely
identifies your company.
<Lightbox src="/img/docs/dbt-cloud/dbt-cloud-enterprise/gsuite/gsuite-sso-cloud-config.png" title="GSuite SSO Configuration"/>
Expand Down
4 changes: 2 additions & 2 deletions website/docs/docs/cloud/manage-access/set-up-sso-okta.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ Click **Next** to continue.

### Configure SAML Settings

The SAML Settings page configures how Okta and dbt Cloud communicate. You will want to use an [appropriate Access URL](/docs/cloud/about-cloud/regions-ip-addresses) for your region and plan.
The SAML Settings page configures how Okta and dbt Cloud communicate. You will want to use an [appropriate Access URL](/docs/cloud/about-cloud/access-regions-ip-addresses) for your region and plan.

To complete this section, you will need a _login slug_. This slug controls the
URL where users on your account can log into your application via Okta. Login
Expand Down Expand Up @@ -172,7 +172,7 @@ configured in the steps above.
| **Identity&nbsp;Provider&nbsp;SSO&nbsp;Url** | Paste the **Identity Provider Single Sign-On URL** shown in the Okta setup instructions |
| **Identity&nbsp;Provider&nbsp;Issuer** | Paste the **Identity Provider Issuer** shown in the Okta setup instructions |
| **X.509&nbsp;Certificate** | Paste the **X.509 Certificate** shown in the Okta setup instructions; <br />**Note:** When the certificate expires, an Okta admin will have to generate a new one to be pasted into dbt Cloud for uninterrupted application access. |
| **Slug** | Enter your desired login slug. Users will be able to log into dbt Cloud by navigating to `https://YOUR_ACCESS_URL/enterprise-login/LOGIN-SLUG`, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/regions-ip-addresses) for your region and plan. Login slugs must be unique across all dbt Cloud accounts, so pick a slug that uniquely identifies your company. |
| **Slug** | Enter your desired login slug. Users will be able to log into dbt Cloud by navigating to `https://YOUR_ACCESS_URL/enterprise-login/LOGIN-SLUG`, replacing `YOUR_ACCESS_URL` with the [appropriate Access URL](/docs/cloud/about-cloud/access-regions-ip-addresses) for your region and plan. Login slugs must be unique across all dbt Cloud accounts, so pick a slug that uniquely identifies your company. |

<Lightbox
collapsed={false}
Expand Down
Loading
Loading