Skip to content

Commit

Permalink
add note about enterprise plans (#5916)
Browse files Browse the repository at this point in the history
add clarifying info that acct-level connections feature isn't yet
available to enterprise plans (and free plans) yet. [internal slack
thread](https://dbt-labs.slack.com/archives/C05CJT5MJF2/p1722613501740939)
  • Loading branch information
mirnawong1 authored Aug 28, 2024
1 parent d4af450 commit b3ad0e0
Showing 1 changed file with 7 additions and 8 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -27,30 +27,29 @@ These connection instructions provide the basic fields required for configuring

## Connection management

:::info Connections are moving!
:::info Connection management now at account-level

Up until July 2024, connections were nested under projects. One dbt Cloud project could only have one connection, which was re-used across all its environments. Extended attributes were leveraged to switch warehouse instances depending on the environment for a given project.
Starting July 2024, connection management has moved from the project level to the account level for all users in dbt Cloud. Previously, each dbt Cloud project could only have one connection, which was used across all its environments. Extended attributes were used to switch warehouse instances depending on the environment for a given project.

<Lightbox src="/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/connections-legacy-model.png" width="60%" title="Previous connection model"/>
<Lightbox src="/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/connections-legacy-model.png" width="55%" title="Previous connection model"/>

We are rolling out an important change that moves connection management to the account level. The following connection management section describes these changes.
The following connection management section describes these changes.

This feature is being rolled out in phases over the coming weeks.
:::

Warehouse connections are an account-level resource. As such you can find them under **Accounts Settings** > **Connections**:

<Lightbox src="/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/connections-list.png" width="60%" title="Connection list"/>

Warehouse connections can be re-used across projects. If multiple projects all connect to the same warehouse, you should re-use the same connection in order to streamline your management operations. Connections are assigned to a project via an [environment](/docs/dbt-cloud-environments).
Warehouse connections can be re-used across projects. If multiple projects all connect to the same warehouse, you should re-use the same connection to streamline your management operations. Connections are assigned to a project via an [environment](/docs/dbt-cloud-environments).

<Lightbox src="/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/connections-new-model.png" width="60%" title="Connection model"/>

As shown in the image, a project with 2 environments can target between 1 and 2 different connections. If you want to separate your production environment from your non-production environment, assign multiple connections to a single project.

### Migration from project level connections to account level connections

Rolling out account-level connections will not require any interruption of service in your current usage (IDE, CLI, jobs, etc.).
Rolling out account-level connections will not require any interruption of service in your current usage (IDE, CLI, jobs, and so on.).

:::info Why am I prompted to configure a development environment?
If your project did not previously have a development environment, you may be redirected to the project setup page. Your project is still intact. Choose a connection for your new development environment, and you can view all your environments again.
Expand All @@ -60,7 +59,7 @@ However, to fully utilize the value of account-level connections, you may have t

<Lightbox src="/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/connections-post-rollout.png" width="60%" title="Typical connection setup post rollout"/>

Please consider all of the following actions, as the steps you take will depend on the desired outcome.
Please consider the following actions, as the steps you take will depend on the desired outcome.

- The initial clean-up of your connection list
- Delete unused connections with 0 environments.
Expand Down

0 comments on commit b3ad0e0

Please sign in to comment.