-
Notifications
You must be signed in to change notification settings - Fork 977
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'current' into mwong-macro-yml
- Loading branch information
Showing
58 changed files
with
478 additions
and
276 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,30 @@ | ||
| --- | ||
| title: About developing in dbt | ||
| id: about-develop-dbt | ||
| description: "Learn how to develop your dbt projects using dbt Cloud." | ||
| sidebar_label: "About developing in dbt" | ||
| pagination_next: "docs/cloud/about-cloud-develop-defer" | ||
| hide_table_of_contents: true | ||
| --- | ||
|
|
||
| Develop dbt projects using dbt Cloud, which offers a fast and reliable way to work on your dbt project. It runs dbt Core in a hosted (single or multi-tenant) environment. | ||
|
|
||
| You can develop in your browser using an integrated development environment (IDE) or in a dbt Cloud-powered command line interface (CLI). | ||
|
|
||
| <div className="grid--2-col" > | ||
|
|
||
| <Card | ||
| title="dbt Cloud CLI" | ||
| body="Allows you to develop and run dbt commands from your local command line or code editor against your dbt Cloud development environment." | ||
| link="/docs/cloud/cloud-cli-installation" | ||
| icon="dbt-bit"/> | ||
|
|
||
| <Card | ||
| title="dbt Cloud IDE" | ||
| body="Develop directly in your browser, making dbt project development efficient by compiling code into SQL and managing project changes seamlessly using an intuitive user interface." | ||
| link="/docs/cloud/dbt-cloud-ide/develop-in-the-cloud" | ||
| icon="dbt-bit"/> | ||
|
|
||
| </div><br /> | ||
|
|
||
| To get started with dbt development, you'll need a [dbt Cloud](https://www.getdbt.com/signup) account and developer seat. For a more comprehensive guide about developing in dbt, refer to our [quickstart guides](/guides). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,76 @@ | ||
| --- | ||
| title: "Invite users to dbt Cloud" | ||
| description: "Learn how to manually invite users to dbt Cloud" | ||
| id: "invite-users" | ||
| sidebar: "Invite users" | ||
| --- | ||
|
|
||
| dbt Cloud makes it easy to invite new users to your environment out of the box. This feature is available to all dbt Cloud customers on Teams or Enteprise plans (Developer plans are limited to a single user). | ||
|
|
||
| ## Prerequisites | ||
|
|
||
| You must have proper permissions to invite new users: | ||
|
|
||
| - [**Teams accounts**](/docs/cloud/manage-access/self-service-permissions) — must have `member` or `owner` permissions. | ||
| - [**Enterprise accounts**](/docs/cloud/manage-access/enterprise-permissions) — must have `admin`, `account admin`, `project creator`, or `security admin` permissions. | ||
| - The admin inviting the users must have a `developer` or `IT` license. | ||
|
|
||
| ## Invite new users | ||
|
|
||
| 1. In your dbt Cloud account, select the gear menu in the upper right corner and then select **Account Settings**. | ||
| 2. From the left sidebar, select **Users**. | ||
|
|
||
| <Lightbox src="/img/docs/dbt-cloud/access-control/users-screen.png" title="The user screen in the Account Settings page"/> | ||
|
|
||
| 3. Click on **Invite Users**. | ||
|
|
||
| <Lightbox src="/img/docs/dbt-cloud/access-control/invite-users.png" title="The invite users pane"/> | ||
|
|
||
| 4. In the **Email Addresses** field, enter the email addresses of the users you would like to invite separated by comma, semicolon, or a new line. | ||
| 5. Select the license type for the batch of users from the **License** dropdown. | ||
| 6. Select the group(s) you would like the invitees to belong to. | ||
| 7. Click **Send Invitations**. | ||
| - If the list of invitees exceeds the number of licenses your account has available, you will receive a warning when you click **Send Invitations** and the invitations will not be sent. | ||
|
|
||
|
|
||
| ## 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). | ||
|
|
||
|
|
||
| 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. | ||
|
|
||
| <Lightbox src="/img/docs/dbt-cloud/access-control/email-invite.png" title="Example or an email invitation"/> | ||
|
|
||
| <Tabs> | ||
|
|
||
| <TabItem value="Local user"> | ||
|
|
||
| The default settings send the email, the user clicks the link, and is prompted to create their account: | ||
|
|
||
| <Lightbox src="/img/docs/dbt-cloud/access-control/default-user-invite.png" title="Default user invitation"/> | ||
|
|
||
| </TabItem> | ||
|
|
||
| <TabItem value="SSO user"> | ||
|
|
||
| If SSO is configured for the environment, the user clicks the link, is brought to a confirmation screen, and presented with a link to authenticate against the company's identity provider: | ||
|
|
||
| <Lightbox src="/img/docs/dbt-cloud/access-control/sso-user-invite.png" title="User invitation with SSO configured"/> | ||
|
|
||
| </TabItem> | ||
|
|
||
| </Tabs> | ||
|
|
||
|
|
||
| Once the user completes this process, their email and user information will populate in the **Users** screen in dbt Cloud. | ||
|
|
||
| ## FAQ | ||
|
|
||
| * Is there a limit to the number of users I can invite? _Your ability to invite users is limited to the number of licenses you have available._ | ||
| * Why are users are clicking the invitation link and getting an `Invalid Invitation Code` error? _We have seen scenarios where embedded secure link technology (such as enterprise Outlooks [Safe Link](https://learn.microsoft.com/en-us/microsoft-365/security/office-365-security/safe-links-about?view=o365-worldwide) feature) can result in errors when clicking on the email link. Be sure to include the `getdbt.com` URL in the allowlists for these services._ | ||
| * Can I have a mixure of users with SSO and username/password authentication? _Once SSO is enabled, you will no longer be able to add local users. If you have contractors or similar contingent workers, we recommend you add them to your SSO service._ | ||
| * What happens if I need to resend the invitation? _From the Users page, click on the invite record, and you will be presented with the option to resend the invitation._ | ||
| * What can I do if I entered an email address incorrectly? _From the Users page, click on the invite record, and you will be presented with the option to revoke it. Once revoked, generate a new invitation to the correct email address._ | ||
|
|
||
| <Lightbox src="/img/docs/dbt-cloud/access-control/resend-invite.png" title="Resend or revoke the users invitation"/> |
46 changes: 46 additions & 0 deletions
46
website/docs/docs/collaborate/explore-multiple-projects.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,46 @@ | ||
| --- | ||
| title: "Explore multiple projects" | ||
| sidebar_label: "Explore multiple projects" | ||
| description: "Learn about project-level lineage in dbt Explorer and its uses." | ||
| pagination_next: null | ||
| --- | ||
|
|
||
| You can also view all the different projects and public models in the account, where the public models are defined, and how they are used to gain a better understanding about your cross-project resources. | ||
|
|
||
| The resource-level lineage graph for a given project displays the cross-project relationships in the DAG. The different icons indicate whether you’re looking at an upstream producer project (parent) or a downstream consumer project (child). | ||
|
|
||
| When you view an upstream (parent) project, its public models display a counter icon in the upper right corner indicating how many downstream (child) projects depend on them. Selecting a model reveals the lineage indicating the projects dependent on that model. These counts include all projects listing the upstream one as a dependency in its `dependencies.yml`, even without a direct `{{ ref() }}`. Selecting a project node from a public model opens its detailed lineage graph, which is subject to your [permission](/docs/cloud/manage-access/enterprise-permissions). | ||
|
|
||
| <Lightbox src="/img/docs/collaborate/dbt-explorer/cross-project-lineage-parent.png" width="80%" height="100" title="Cross-project lineage in a parent project"/> | ||
|
|
||
| When viewing a downstream (child) project that imports and refs public models from upstream (parent) projects, public models will show up in the lineage graph and display an icon on the graph edge that indicates what the relationship is to a model from another project. Hovering over this icon indicates the specific dbt Cloud project that produces that model. Double-clicking on a model from another project opens the resource-level lineage graph of the parent project, which is subject to your permissions. | ||
|
|
||
|
|
||
| <Lightbox src="/img/docs/collaborate/dbt-explorer/cross-project-lineage-child.png" width="85%" height="100" title="Cross-project lineage in a child project"/> | ||
|
|
||
| ## Explore the project-level lineage graph | ||
|
|
||
| For cross-project collaboration, you can interact with the DAG in all the same ways as described in [Explore your project's lineage](/docs/collaborate/explore-projects#project-lineage) but you can also interact with it at the project level and view the details. | ||
|
|
||
| To get a list view of all the projects, select the account name at the top of the **Explore** page near the navigation bar. This view includes a public model list, project list, and a search bar for project searches. You can also view the project-level lineage graph by clicking the Lineage view icon in the page's upper right corner. | ||
|
|
||
| If you have permissions for a project in the account, you can view all public models used across the entire account. However, you can only view full public model details and private models if you have permissions for a project where the models are defined. | ||
|
|
||
| From the project-level lineage graph, you can: | ||
|
|
||
| - Click the Lineage view icon (in the graph’s upper right corner) to view the cross-project lineage graph. | ||
| - Click the List view icon (in the graph’s upper right corner) to view the project list. | ||
| - Select a project from the **Projects** tab to switch to that project’s main **Explore** page. | ||
| - Select a model from the **Public Models** tab to view the [model’s details page](/docs/collaborate/explore-projects#view-resource-details). | ||
| - Perform searches on your projects with the search bar. | ||
| - Select a project node in the graph (double-clicking) to switch to that particular project’s lineage graph. | ||
|
|
||
| When you select a project node in the graph, a project details panel opens on the graph’s right-hand side where you can: | ||
|
|
||
| - View counts of the resources defined in the project. | ||
| - View a list of its public models, if any. | ||
| - View a list of other projects that uses the project, if any. | ||
| - Click **Open Project Lineage** to switch to the project’s lineage graph. | ||
| - Click the Share icon to copy the project panel link to your clipboard so you can share the graph with someone. | ||
|
|
||
| <LoomVideo id='606f02e1cce343eba7e1061d6273ff0a?t=1' /> |
Oops, something went wrong.