Merge pull request #285650 from whhender/synapse-freshness-august-2024

Freshness

Author: AnnaMHuff

articles/synapse-analytics/get-started-create-workspace.md

@@ -1,38 +1,42 @@
 ---
-title: 'Quickstart: Get started - create a Synapse workspace' 
-description: In this tutorial, you'll learn how to create a Synapse workspace, a dedicated SQL pool, and a serverless Apache Spark pool.
+title: 'Quickstart: Create a Synapse workspace' 
+description: In this quickstart, you'll learn how to create a Synapse workspace, a dedicated SQL pool, and a serverless Apache Spark pool.
 author: whhender
 ms.author: whhender
 ms.reviewer: whhender
 ms.service: azure-synapse-analytics
 ms.subservice: workspace
-ms.topic: tutorial
-ms.date: 11/18/2022
+ms.topic: quickstart
+ms.date: 08/27/2024
 ---
 
-# Creating a Synapse workspace
+# Quickstart: Create a Synapse workspace
 
-In this tutorial, you'll learn how to create a Synapse workspace, a dedicated SQL pool, and a serverless Apache Spark pool. 
+In this Quickstart, you will create a Synapse workspace, and you can follow along with the rest of the tutorials to create a dedicated SQL pool, and a serverless Apache Spark pool.
 
 ## Prerequisites
 
-To complete this tutorial's steps, you need to have access to a resource group for which you're assigned the **Owner** role. Create the Synapse workspace in this resource group.
+- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
+- To complete this tutorial's steps, you need to have access to a resource group for which you're assigned the **Owner** role. Create the Synapse workspace in this resource group.
 
 ## Create a Synapse workspace in the Azure portal
 
 ### Start the process
+
 1. Open the [Azure portal](https://portal.azure.com), in the search bar enter **Synapse** without hitting enter.
 1. In the search results, under **Services**, select **Azure Synapse Analytics**.
 1. Select **Create** to create a workspace.
 
 ## Basics tab > Project Details
+
 Fill in the following fields:
 
 1. **Subscription** - Pick any subscription.
 1. **Resource group** - Use any resource group.
 1. **Managed Resource group** - Leave this blank.
 
 ## Basics tab > Workspace details
+
 Fill in the following fields:
 
 1. **Workspace name** - Pick any globally unique name. In this tutorial, we'll use **myworkspace**.
@@ -44,10 +48,15 @@ Fill in the following fields:
 Under **Select Data Lake Storage Gen 2**:
 
 1. By **Account name**, select **Create New** and name the new storage account **contosolake** or similar as the name must be unique.
+
+    >[!TIP]
+    >If you get an error reading *"The Azure Synapse resource provider (Microsoft.Synapse) needs to be registered with the selected subscription"*, open the Azure portal and select **Subscriptions**. Select your subscription. Under the **Settings** list select **Resource providers**. Search for **Microsoft.Synapse**, select it, and select **Register**.
+
 1. By **File system name**, select **Create New** and name it **users**. This will create a storage container called **users**. The workspace will use this storage account as the "primary" storage account to Spark tables and Spark application logs.
-1. Check the "Assign myself the Storage Blob Data Contributor role on the Data Lake Storage Gen2 account" box. 
+1. Check the **Assign myself the Storage Blob Data Contributor role on the Data Lake Storage Gen2 account** box. 
 
 ## Completing the process
+
 Select **Review + create** > **Create**. Your workspace is ready in a few minutes.
 
 > [!NOTE]
@@ -66,21 +75,24 @@ After your Azure Synapse workspace is created, you have two ways to open Synapse
 > To sign into your workspace, there are two **Account selection methods**. One is from **Azure subscription**, the other is from **Enter manually**. If you have the Synapse Azure role or higher level Azure roles, you can use both methods to log into the workspace. If you don't have the related Azure roles, and you were granted as the Synapse RBAC role, **Enter manually** is the only way to log into the workspace. To learn more about the Synapse RBAC, refer to [What is Synapse role-based access control (RBAC)](./security/synapse-workspace-synapse-rbac.md).
 
 ## Place sample data into the primary storage account
-We're going to use a small 100 K row sample dataset of NYC Taxi Cab data for many examples in this getting started guide. We begin by placing it in the primary storage account you created for the workspace.
 
-* Download the [NYC Taxi - green trip dataset](../open-datasets/dataset-taxi-green.md?tabs=azureml-opendatasets#additional-information) to your computer. Navigate to the [original dataset location](https://www.nyc.gov/site/tlc/about/tlc-trip-record-data.page) from the link, choose a specific year and download the Green taxi trip records in Parquet format.
-* Rename the downloaded file to *NYCTripSmall.parquet*.
-* In Synapse Studio, navigate to the **Data** Hub.
-* Select **Linked**.
-* Under the category Azure Data Lake Storage Gen2,** you'll see an item with a name like **myworkspace ( Primary - contosolake )**.
-* Select the container named **users (Primary)**.
-* Select **Upload** and select the `NYCTripSmall.parquet` file you downloaded.
+We're going to use a small 100k row sample dataset of NYC Taxi Cab data for many examples in this getting started guide. We begin by placing it in the primary storage account you created for the workspace.
+
+1. Download the [NYC Taxi - green trip dataset](../open-datasets/dataset-taxi-green.md?tabs=azureml-opendatasets#additional-information) to your computer: 
+    1. Navigate to the [original dataset location](https://www.nyc.gov/site/tlc/about/tlc-trip-record-data.page) from the link, choose a specific year and download the Green taxi trip records in Parquet format.
+    1. Rename the downloaded file to *NYCTripSmall.parquet*.
+1. In Synapse Studio, navigate to the **Data** hub.
+1. Select **Linked**.
+1. Under the category **Azure Data Lake Storage Gen2**, you'll see an item with a name like **myworkspace ( Primary - contosolake )**.
+1. Select the container named **users (Primary)**.
+1. Select **Upload** and select the `NYCTripSmall.parquet` file you downloaded.
 
 Once the parquet file is uploaded, it's available through two equivalent URIs:
 * `https://contosolake.dfs.core.windows.net/users/NYCTripSmall.parquet` 
 * `abfss://[email protected]/NYCTripSmall.parquet`
 
-In the examples that follow in this tutorial, make sure to replace **contosolake** in the UI with the name of the primary storage account that you selected for your workspace.
+>[!TIP]
+>In the examples that follow in this tutorial, make sure to replace **contosolake** in the UI with the name of the primary storage account that you selected for your workspace.
 
 ## Next steps