Skip to content

Commit

Permalink
Updating Databricks QS (#6123)
Browse files Browse the repository at this point in the history
## What are you changing in this pull request and why?

Databricks trial sign up workflows have changed and this updates the
quickstart guide with the new workflows.

## Checklist
- [ ] I have reviewed the [Content style
guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md)
so my content adheres to these guidelines.
- [ ] The topic I'm writing about is for specific dbt version(s) and I
have versioned it according to the [version a whole
page](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#adding-a-new-version)
and/or [version a block of
content](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-blocks-of-content)
guidelines.
- [ ] I have added checklist item(s) to this list for anything anything
that needs to happen before this PR is merged, such as "needs technical
review" or "change base branch."
<!--
PRE-RELEASE VERSION OF dbt (if so, uncomment):
- [ ] Add a note to the prerelease version [Migration
Guide](https://github.com/dbt-labs/docs.getdbt.com/tree/current/website/docs/docs/dbt-versions/core-upgrade)
-->
<!-- 
ADDING OR REMOVING PAGES (if so, uncomment):
- [ ] Add/remove page in `website/sidebars.js`
- [ ] Provide a unique filename for new pages
- [ ] Add an entry for deleted pages in `website/vercel.json`
- [ ] Run link testing locally with `npm run build` to update the links
that point to deleted pages
-->

---------

Co-authored-by: nataliefiann <[email protected]>
  • Loading branch information
matthewshaver and nataliefiann authored Sep 24, 2024
1 parent 9206e64 commit 19dea92
Show file tree
Hide file tree
Showing 5 changed files with 15 additions and 18 deletions.
33 changes: 15 additions & 18 deletions website/docs/guides/databricks-qs.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,36 +41,33 @@ You can check out [dbt Fundamentals](https://learn.getdbt.com/courses/dbt-fundam

## Create a Databricks workspace

1. Use your existing account or [sign up for a Databricks account](https://databricks.com/). Complete the form with your user information.
1. Use your existing account or [sign up for a Databricks account](https://databricks.com/). Complete the form with your user information and click **Continue**.

<div style={{maxWidth: '400px'}}>
<Lightbox src="/img/databricks_tutorial/images/signup_form.png" title="Sign up for Databricks" />
</div>

2. For the purpose of this tutorial, you will be selecting AWS as our cloud provider but if you use Azure or GCP internally, please choose one of them. The setup process will be similar.
3. Check your email to complete the verification process.
4. After setting up your password, you will be guided to choose a subscription plan. Select the `Premium` or `Enterprise` plan to access the SQL Compute functionality required for using the SQL warehouse for dbt. We have chosen `Premium` for this tutorial. Click **Continue** after selecting your plan.

<div style={{maxWidth: '400px'}}>
<Lightbox src="/img/databricks_tutorial/images/choose_plan.png" title="Choose Databricks Plan" />
2. On the next screen, select your cloud provider. This tutorial uses AWS as the cloud provider, but if you use Azure or GCP internally, please select your platform. The setup process will be similar. Do not select the **Get started with Community Edition** option, as this will not provide the required compute for this guide.

<div style={{maxWidth: '400px'}}>
<Lightbox src="/img/databricks_tutorial/images/choose_provider.png" title="Choose cloud provider" />
</div>

5. Click **Get Started** when you come to this below page and then **Confirm** after you validate that you have everything needed.
3. Check your email and complete the verification process.

4. After completing the verification processes, you will be brought to the first setup screen. Databricks defaults to the `Premium` plan and you can change the trial to `Enterprise` on this page.

<div style={{maxWidth: '400px'}}>
<Lightbox src="/img/databricks_tutorial/images/validate_1.png" />
</div>
<div style={{maxWidth: '400px'}}>
<Lightbox src="/img/databricks_tutorial/images/validate_2.png" />
<Lightbox src="/img/databricks_tutorial/images/choose_plan.png" title="Choose Databricks Plan" />
</div>

6. Now it's time to create your first workspace. A Databricks workspace is an environment for accessing all of your Databricks assets. The workspace organizes objects like notebooks, SQL warehouses, clusters, etc into one place. Provide the name of your workspace and choose the appropriate AWS region and click **Start Quickstart**. You might get the checkbox of **I have data in S3 that I want to query with Databricks**. You do not need to check this off for the purpose of this tutorial.
5. Now, it's time to create your first workspace. A Databricks workspace is an environment for accessing all of your Databricks assets. The workspace organizes objects like notebooks, SQL warehouses, clusters, and more so into one place. Provide the name of your workspace, choose the appropriate AWS region, and click **Start Quickstart**. You might get the checkbox of **I have data in S3 that I want to query with Databricks**. You do not need to check this off for this tutorial.

<div style={{maxWidth: '400px'}}>
<Lightbox src="/img/databricks_tutorial/images/setup_first_workspace.png" title="Setup First Workspace" />
<Lightbox src="/img/databricks_tutorial/images/start_quickstart.png" title="Create AWS resources" />
</div>

7. By clicking on `Start Quickstart`, you will be redirected to AWS and asked to log in if you haven’t already. After logging in, you should see a page similar to this.
6. By clicking on `Start Quickstart`, you will be redirected to AWS and asked to log in if you haven’t already. After logging in, you should see a page similar to this.

<div style={{maxWidth: '400px'}}>
<Lightbox src="/img/databricks_tutorial/images/quick_create_stack.png" title="Create AWS resources" />
Expand All @@ -80,7 +77,7 @@ You can check out [dbt Fundamentals](https://learn.getdbt.com/courses/dbt-fundam
If you get a session error and don’t get redirected to this page, you can go back to the Databricks UI and create a workspace from the interface. All you have to do is click **create workspaces**, choose the quickstart, fill out the form and click **Start Quickstart**.
:::

8. There is no need to change any of the pre-filled out fields in the Parameters. Just add in your Databricks password under **Databricks Account Credentials**. Check off the Acknowledgement and click **Create stack**.
7. There is no need to change any of the pre-filled out fields in the Parameters. Just add in your Databricks password under **Databricks Account Credentials**. Check off the Acknowledgement and click **Create stack**.
<div style={{maxWidth: '400px'}}>
<Lightbox src="/img/databricks_tutorial/images/parameters.png" title="Parameters" />
</div>
Expand All @@ -89,11 +86,11 @@ If you get a session error and don’t get redirected to this page, you can go b
<Lightbox src="/img/databricks_tutorial/images/create_stack.png" title="Capabilities" />
</div>

10. Go back to the Databricks tab. You should see that your workspace is ready to use.
8. Go back to the Databricks tab. You should see that your workspace is ready to use.
<div style={{maxWidth: '400px'}}>
<Lightbox src="/img/databricks_tutorial/images/workspaces.png" title="A Databricks Workspace" />
</div>
11. Now let’s jump into the workspace. Click **Open** and log into the workspace using the same login as you used to log into the account.
9. Now let’s jump into the workspace. Click **Open** and log into the workspace using the same login as you used to log into the account.

## Load data

Expand Down
Binary file modified website/static/img/databricks_tutorial/images/choose_plan.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified website/static/img/databricks_tutorial/images/signup_form.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 19dea92

Please sign in to comment.