Skip to main content

Step 3: Create a Workspace

Before creating a Workspace, you should make sure you have a Project created with version control. You can choose from username and password or OAuth.

A Workspace is a sandbox environment where you can complete the development of your data, refine, and perform preliminary validation before merging them into the codebase.

Workspace Best Practices

Snowflake

  1. Select the Project you want to create the Workspace in.

  2. Click Create Workspace.

  3. Workspace Details

    1. Give your Workspace a Name and Description(optional).
  4. Connect Snowflake to this Workspace

  5. Enter your Snowflake Account URL.

    1. If you want to use OAuth, toggle Snowflake OAuth on.
    2. On the next page, enter your Client ID and Client Secret. Then enter your Warehouse and Role. Review Snowflake OAuth to learn how to generate the ID and Secret.
  6. If you didn't choose OAuth, you'll need to Add your Snowflake Credentials on the next screen.

    1. Choose Key Pair or Username and Password (not recommended).
  7. Set Up Version Control

    1. Workspaces let you work on a branch. You will need to select a branch and commit to make a new branch. For example, if you want to create a branch off main, select main, then select the commit in main to create your branch from.
    2. Then give the new branch a name.
  8. Storage Location and Storage Mappings

    1. Add Storage Locations and Storage Mappings to your Workspace. If you have any existing Storage Locations and Storage Mappings from your repo, they will be listed here.
    Storage Locations and Mappings configuration interface showing two locations (WORK and EDW), with EDW expanded to display database mapping to EDW_APAC and schema mapping to DEV_EDW. Interface includes toggle for manual mapping and option to set WORK as default storage location.
  9. Click Create Workspace. You've just created your Workspace.

Databricks

  1. Select the Project you want to create the Workspace in. The Project will have your Git information saved from Step 2: Create a Project.

  2. Click Create Workspace.

  3. Give your Workspace a Name and Description(optional).

    This image shows a Create Workspace dialog box with a two-step process. Currently on step 1 Details, with step 2 Create Branch shown as inactive. The form includes required fields for Name (marked with an asterisk), Description, and Tag Color options with blue selected for background and light gray for text.
  4. Workspaces let you work in a branch in Git. You will need to select a current branch to make a new branch from. For example, if you want to create a branch off main, select main, then the commit you want to start from, and then in New Branch Name, enter the new branch name.

    The image shows the Create Workspace interface where a user can create a new branch from the main branch. The interface displays recent commits, including one labeled added a package committed 2 hours ago. The user is prompted to enter a new branch name before proceeding with the workspace creation, with the option to go back or create the workspace.
  5. Then click Create.

  6. Your new Workspace will be created with the new branch.


What's Next?

Review the Coalesce Fundamentals to learn more about: