edit pass: synapse-workspace-quickstarts

paulth1 · paulth1 · commit 42694a863167 · 2024-08-01T16:32:48.000-07:00
diff --git a/articles/synapse-analytics/quickstart-create-workspace-cli.md b/articles/synapse-analytics/quickstart-create-workspace-cli.md
@@ -1,6 +1,6 @@
 ---
-title: 'Quickstart: Create a Synapse workspace using Azure CLI'
-description: Create an Azure Synapse workspace using Azure CLI by following the steps in this guide.
+title: 'Quickstart: Create an Azure Synapse Analytics workspace using Azure CLI'
+description: Create an Azure Synapse Analytics workspace using the Azure CLI by following the steps in this article.
 author: WilliamDAssafMSFT
 ms.service: azure-synapse-analytics
 ms.topic: quickstart
@@ -11,46 +11,48 @@ ms.reviewer: whhender
 ms.custom: mode-api, devx-track-azurecli
 ---
 
-# Quickstart: Create an Azure synapse workspace with Azure CLI
+# Quickstart: Create an Azure Synapse Analytics workspace with the Azure CLI
 
 The Azure CLI is Azure's command-line experience for managing Azure resources. You can use it in your browser with Azure Cloud Shell. You can also install it on macOS, Linux, or Windows and run it from the command line.
 
-In this quickstart, you learn to create a Synapse workspace by using the Azure CLI.
+In this quickstart, you learn how to create an Azure Synapse Analytics workspace by using the Azure CLI.
 
 [!INCLUDE [quickstarts-free-trial-note](~/reusable-content/ce-skilling/azure/includes/quickstarts-free-trial-note.md)]
 
 ## Prerequisites
 
-- Download and install [jq](https://stedolan.github.io/jq/download/), a lightweight and flexible command-line JSON processor
-- [Azure Data Lake Storage Gen2 storage account](../storage/common/storage-account-create.md)
+- Download and install [jq](https://stedolan.github.io/jq/download/), a lightweight and flexible command-line JSON processor.
+- [Azure Data Lake Storage Gen2 storage account](../storage/common/storage-account-create.md).
 
     > [!IMPORTANT]
-    > The Azure Synapse workspace needs to be able to read and write to the selected ADLS Gen2 account. In addition, for any storage account that you link as the primary storage account, you must have enabled **hierarchical namespace**  at the creation of the storage account, as described on the [Create a Storage Account](../storage/common/storage-account-create.md?tabs=azure-portal#create-a-storage-account) page. 
+    > An Azure Synapse Analytics workspace needs to be able to read and write to the selected Data Lake Storage Gen2 account. In addition, for any storage account that you link as the primary storage account, you must have enabled **hierarchical namespace**  at the creation of the storage account, as described on the [Create a storage account](../storage/common/storage-account-create.md?tabs=azure-portal#create-a-storage-account) page.
 
 [!INCLUDE [azure-cli-prepare-your-environment.md](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
 
-## Create an Azure Synapse workspace using the Azure CLI
+## Create an Azure Synapse Analytics workspace by using the Azure CLI
 
-1. Define necessary environment variables to create resources for Azure Synapse workspace.
+1. Define necessary environment variables to create resources for an Azure Synapse Analytics workspace.
 
-    | Environment Variable Name | Description |
+    | Environment Variable name | Description |
     |---|---|---|
-    |StorageAccountName| Name for your existing ADLS Gen2 storage account.|
-    |StorageAccountResourceGroup| Name of your existing ADLS Gen2 storage account resource group. |
+    |StorageAccountName| Name for your existing Data Lake Storage Gen2 storage account.|
+    |StorageAccountResourceGroup| Name of your existing Data Lake Storage Gen2 storage account resource group. |
     |FileShareName| Name of your existing storage file system.|
-    |SynapseResourceGroup| Choose a new name for your Azure Synapse resource group. |
+    |SynapseResourceGroup| Choose a new name for your Azure Synapse Analytics resource group. |
     |Region| Choose one of the [Azure regions](https://azure.microsoft.com/global-infrastructure/geographies/#overview). |
-    |SynapseWorkspaceName| Choose a unique name for your new Azure Synapse Workspace. |
+    |SynapseWorkspaceName| Choose a unique name for your new Azure Synapse Analytics workspace. |
     |SqlUser| Choose a value for a new username.|
     |SqlPassword| Choose a secure password.|
     |||
 
-1. Create a resource group as a container for your Azure Synapse workspace:
+1. Create a resource group as a container for your Azure Synapse Analytics workspace:
+
     ```azurecli
     az group create --name $SynapseResourceGroup --location $Region
     ```
 
-1. Create an Azure Synapse Workspace:
+1. Create an Azure Synapse Analytics workspace:
+
     ```azurecli
     az synapse workspace create \
       --name $SynapseWorkspaceName \
@@ -62,14 +64,15 @@ In this quickstart, you learn to create a Synapse workspace by using the Azure C
       --location $Region
     ```
 
-1. Get Web and Dev URL for Azure Synapse Workspace:
+1. Get the web and dev URL for the Azure Synapse Analytics workspace:
+
     ```azurecli
     WorkspaceWeb=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .web')
 
     WorkspaceDev=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .dev')
     ```
 
-1. Create a Firewall Rule to allow your access to Azure Synapse Workspace from your machine:
+1. Create a firewall rule to allow access to your Azure Synapse Analytics workspace from your machine:
 
     ```azurecli
     ClientIP=$(curl -sb -H "Accept: application/json" "$WorkspaceDev" | jq -r '.message')
@@ -79,33 +82,35 @@ In this quickstart, you learn to create a Synapse workspace by using the Azure C
     az synapse workspace firewall-rule create --end-ip-address $ClientIP --start-ip-address $ClientIP --name "Allow Client IP" --resource-group $SynapseResourceGroup --workspace-name $SynapseWorkspaceName
     ```
 
-1. Open the Azure Synapse Workspace Web URL address stored in environment variable `WorkspaceWeb` to access your workspace:
+1. Open the Azure Synapse Analytics workspace web URL address stored in the environment variable `WorkspaceWeb` to access your workspace:
 
     ```azurecli
     echo "Open your Azure Synapse Workspace Web URL in the browser: $WorkspaceWeb"
     ```
     
-    [ ![Azure Synapse workspace web](media/quickstart-create-synapse-workspace-cli/create-workspace-cli-1.png) ](media/quickstart-create-synapse-workspace-cli/create-workspace-cli-1.png#lightbox)
+    [![Screenshot that shows the Azure Synapse Analytics workspace web.](media/quickstart-create-synapse-workspace-cli/create-workspace-cli-1.png) ](media/quickstart-create-synapse-workspace-cli/create-workspace-cli-1.png#lightbox)
 
-1. Once deployed, additional permissions are required. 
-- In the Azure portal, assign other users of the workspace to the **Contributor** role in the workspace. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.yml). 
-- Assign other users the appropriate **[Synapse RBAC roles](security/synapse-workspace-synapse-rbac-roles.md)** using Synapse Studio.
-- A member of the **Owner** role of the Azure Storage account must assign the **Storage Blob Data Contributor** role to the Azure Synapse workspace MSI and other users.
+1. After it's deployed, more permissions are required:
+
+- In the Azure portal, assign other users of the workspace to the Contributor role in the workspace. For instructions, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.yml).
+- Assign other users the appropriate [Synapse role-based access control roles](security/synapse-workspace-synapse-rbac-roles.md) by using Synapse Studio.
+- A member of the Owner role of the Azure Storage account must assign the Storage Blob Data Contributor role to the Azure Synapse Analytics workspace managed service identity and other users.
 
 ## Clean up resources
 
-Follow the steps below to delete the Azure Synapse workspace.
+Follow these steps to delete the Azure Synapse Analytics workspace.
+
 > [!WARNING]
-> Deleting an Azure Synapse workspace will remove the analytics engines and the data stored in the database of the contained SQL pools and workspace metadata. It will no longer be possible to connect to the SQL or Apache Spark endpoints. All code artifacts will be deleted (queries, notebooks, job definitions and pipelines).
+> Deleting an Azure Synapse Analytics workspace removes the analytics engines and the data stored in the database of the contained SQL pools and workspace metadata. It will no longer be possible to connect to the SQL or Apache Spark endpoints. All code artifacts will be deleted (queries, notebooks, job definitions, and pipelines).
 >
-> Deleting the workspace will **not** affect the data in the Data Lake Store Gen2 linked to the workspace.
+> Deleting the workspace won't affect the data in the Data Lake Store Gen2 linked to the workspace.
 
-If you want to delete the Azure Synapse workspace, complete the following command:
+If you want to delete the Azure Synapse Analytics workspace, complete the following command:
 
 ```azurecli
 az synapse workspace delete --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup
 ```
 
-## Next steps
+## Related content
 
 Next, you can [create SQL pools](quickstart-create-sql-pool-studio.md) or [create Apache Spark pools](quickstart-create-apache-spark-pool-studio.md) to start analyzing and exploring your data.
diff --git a/articles/synapse-analytics/quickstart-create-workspace.md b/articles/synapse-analytics/quickstart-create-workspace.md
@@ -1,6 +1,6 @@
 ---
-title: 'Quickstart: create a Synapse workspace'
-description: Create an  Synapse workspace by following the steps in this guide.
+title: 'Quickstart: Create an Azure Synapse Analytics workspace'
+description: Learn how to create an Azure Synapse Analytics workspace by following the steps in this quickstart.
 author: whhender
 ms.service: azure-synapse-analytics
 ms.topic: quickstart
@@ -11,60 +11,61 @@ ms.reviewer: whhender
 ms.custom: subject-rbac-steps, mode-other
 ---
 
-# Quickstart: Create a Synapse workspace
-This quickstart describes the steps to create an Azure Synapse workspace by using the Azure portal.
+# Quickstart: Create an Azure Synapse Analytics workspace
 
-## Create a Synapse workspace
+This quickstart describes the steps to create an Azure Synapse Analytics workspace by using the Azure portal.
 
-1. Open the [Azure portal](https://portal.azure.com), and at the top search for **Synapse**.
+## Create an Azure Synapse Analytics workspace
+
+1. Open the [Azure portal](https://portal.azure.com), and at the top, search for **Synapse**.
 1. In the search results, under **Services**, select **Azure Synapse Analytics**.
 1. Select **Add** to create a workspace.
-1. In the **Basics** tab, give the workspace a unique name. We'll use **mysworkspace** in this document
-1. You need an ADLSGEN2 account to create a workspace. The simplest choice is to create a new one. If you want to re-use an existing one you'll need to perform some additional configuration. 
-1. OPTION 1 Creating a new ADLSGEN2 account 
-    1. Under **Select Data Lake Storage Gen 2 / Account Name**, click **Create New** and provide a global unique name, such as **contosolake**.
-    1. Under **Select Data Lake Storage Gen 2 / File system name**, click **File System** and name it **users**.
-1. OPTION 2 See the [**Prepare a Storage Account**](#prepare-an-existing-storage-account-for-use-with-azure-synapse-analytics) instructions at the bottom of this document.
-1. Your Azure Synapse workspace will use 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 called **/synapse/workspacename**.
+1. On the **Basics** tab, give the workspace a unique name. We use **mysworkspace** in this document.
+1. You need an ADLSGEN2 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.
+1. Option 1: Create a new ADLSGEN2 account:
+    1. Under **Select Data Lake Storage Gen 2** > **Account Name**, select **Create New**. Provide a global unique name, such as **contosolake**.
+    1. Under **Select Data Lake Storage Gen 2** > **File system name**, select **File System** and name it **users**.
+1. Option 2: See the instructions in [Prepare an existing storage account for use with Azure Synapse Analytics](#prepare-an-existing-storage-account-for-use-with-azure-synapse-analytics).
+1. 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*.
 1. Select **Review + create** > **Create**. Your workspace is ready in a few minutes.
 
 > [!NOTE]
-> After creating your Azure Synapse workspace, you will not be able to move the workspace to another Microsoft Entra tenant. If you do so through subscription migration or other actions, you may lose access to the artifacts within the workspace.
+> 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 workspace is created, you have two ways to 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](https://portal.azure.com). On the top of the **Overview** section, select **Launch Synapse Studio**.
-* Go to the `https://web.azuresynapse.net` and sign in to your workspace.
+* Open your Synapse workspace in the [Azure portal](https://portal.azure.com). At the top of the **Overview** section, select **Launch Synapse Studio**.
+* Go to [Azure Synapse Analytics](https://web.azuresynapse.net) and sign in to your workspace.
 
 ## Prepare an existing storage account for use with Azure Synapse Analytics
 
 1. Open the [Azure portal](https://portal.azure.com).
-1. Navigate to an existing ADLSGEN2 storage account
+1. Go to an existing ADLSGEN2 storage account.
 1. Select **Access control (IAM)**.
-1. Select **Add** > **Add role assignment** to open the Add role assignment page.
-1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.yml).
+1. Select **Add** > **Add role assignment** to open the **Add role assignment** page.
+1. Assign the following role. For instructions, see [Assign Azure roles by using the Azure portal](../role-based-access-control/role-assignments-portal.yml).
     
     | Setting | Value |
     | --- | --- |
     | Role | Owner and Storage Blob Data Owner |
     | Assign access to | USER |
-    | Members | your user name |
+    | Members | Your user name |
 
-    ![Add role assignment page in Azure portal.](~/reusable-content/ce-skilling/azure/media/role-based-access-control/add-role-assignment-page.png)
+    ![Screenshot that shows the Add role assignment page in Azure portal.](~/reusable-content/ce-skilling/azure/media/role-based-access-control/add-role-assignment-page.png)
 1. On the left pane, select **Containers** and create a container.
-1. You can give the container any name. In this document, we'll name the container **users**.
+1. You can give the container any name. In this document, we name the container **users**.
 1. 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 workspace might already have access to the storage account. Follow these steps to make sure:
+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](https://portal.azure.com) and the primary storage account chosen for your workspace.
 1. Select **Access control (IAM)**.
-1. Select **Add** > **Add role assignment** to open the Add role assignment page.
-1. Assign the following role. For detailed steps, see [Assign Azure roles using the Azure portal](../role-based-access-control/role-assignments-portal.yml).
+1. Select **Add** > **Add role assignment** to open the **Add role assignment** page.
+1. Assign the following role. For instructions, see [Assign Azure roles by using the Azure portal](../role-based-access-control/role-assignments-portal.yml).
     
     | Setting | Value |
     | --- | --- |
@@ -75,11 +76,11 @@ Managed identities for your Azure Synapse workspace might already have access to
     > [!NOTE]
     > The managed identity name is also the workspace name.
 
-    ![Add role assignment page in Azure portal.](~/reusable-content/ce-skilling/azure/media/role-based-access-control/add-role-assignment-page.png)
+    ![Screenshot that shows the Add role assignment pane in the Azure portal.](~/reusable-content/ce-skilling/azure/media/role-based-access-control/add-role-assignment-page.png)
 1. Select **Save**.
 
-## Next steps
+## Related content
 
 * [Create a dedicated SQL pool](quickstart-create-sql-pool-studio.md) 
 * [Create a serverless Apache Spark pool](quickstart-create-apache-spark-pool-portal.md)
-* [Use serverless SQL pool](quickstart-sql-on-demand.md)
+* [Use a serverless SQL pool](quickstart-sql-on-demand.md)
