Edit

Share via


Quickstart: Create an Azure Synapse Analytics workspace

This quickstart describes the steps to create an Azure Synapse Analytics workspace by using the Azure portal.

Create an Azure Synapse Analytics workspace

  1. Open the Azure portal, and at the top, search for Synapse.

  2. In the search results, under Services, select Azure Synapse Analytics.

  3. Select Add to create a workspace.

  4. On the Basics tab, give the workspace a unique name. We use mysworkspace in this document.

  5. You need an Azure Data Lake Storage Gen2 account to create a workspace. The simplest choice is to create a new one. If you want to reuse an existing one, you need to perform extra configuration:

    • Option 1: Create a new Data Lake Storage Gen2 account:
      1. Under Select Data Lake Storage Gen 2 > Account Name, select Create New. Provide a global unique name, such as contosolake.
      2. Under Select Data Lake Storage Gen 2 > File system name, select File System and name it users.
    • Option 2: See the instructions in Prepare an existing storage account for use with Azure Synapse Analytics.
  6. Your Azure Synapse Analytics workspace uses this storage account as the primary storage account and the container to store workspace data. The workspace stores data in Apache Spark tables. It stores Spark application logs under a folder named /synapse/workspacename.

  7. Select Review + create > Create. Your workspace is ready in a few minutes.

Note

After you create your Azure Synapse Analytics workspace, you won't be able to move the workspace to another Microsoft Entra tenant. If you do so through subscription migration or other actions, you might lose access to the artifacts within the workspace.

Open Synapse Studio

After your Azure Synapse Analytics workspace is created, you have two ways to open Synapse Studio:

  • Open your Synapse workspace in the Azure portal. At the top of the Overview section, select Launch Synapse Studio.
  • Go to Azure Synapse Analytics and sign in to your workspace.

Prepare an existing storage account for use with Azure Synapse Analytics

  1. Open the Azure portal.

  2. Go to an existing Data Lake Storage Gen2 storage account.

  3. Select Access control (IAM).

  4. Select Add > Add role assignment to open the Add role assignment page.

  5. Assign the following role. For more information, see Assign Azure roles by using the Azure portal.

    Setting Value
    Role Owner and Storage Blob Data Owner
    Assign access to USER
    Members Your user name

    Screenshot that shows the Add role assignment page in Azure portal.

  6. On the left pane, select Containers and create a container.

  7. You can give the container any name. In this document, we name the container users.

  8. Accept the default setting Public access level, and then select Create.

Configure access to the storage account from your workspace

Managed identities for your Azure Synapse Analytics workspace might already have access to the storage account. Follow these steps to make sure:

  1. Open the Azure portal and the primary storage account chosen for your workspace.

  2. Select Access control (IAM).

  3. Select Add > Add role assignment to open the Add role assignment page.

  4. Assign the following role. For more information, see Assign Azure roles by using the Azure portal.

    Setting Value
    Role Storage Blob Data Contributor
    Assign access to MANAGEDIDENTITY
    Members myworkspace

    Note

    The managed identity name is also the workspace name.

    Screenshot that shows the Add role assignment pane in the Azure portal.

  5. Select Save.