20240311 spark support in quickstarts, edit pass

Author: WilliamDAssafMSFT

articles/synapse-analytics/quickstart-create-apache-spark-pool-portal.md

@@ -1,19 +1,20 @@
 ---
-title: 'Quickstart: Create a serverless Apache Spark pool using the Azure portal'
+title: "Quickstart: Create a serverless Apache Spark pool using the Azure portal"
 description: Create a serverless Apache Spark pool using the Azure portal by following the steps in this guide.
 author: WilliamDAssafMSFT
+ms.author: wiassaf
+ms.reviewer: sngun, eskot
+ms.date: 03/11/2024
 ms.service: synapse-analytics
-ms.topic: quickstart
 ms.subservice: spark
-ms.date: 08/19/2021
-ms.author: wiassaf
-ms.reviewer: sngun
-ms.custom: mode-ui
+ms.topic: quickstart
+ms.custom:
+  - mode-ui
 ---
 
 # Quickstart: Create a new serverless Apache Spark pool using the Azure portal
 
-Azure Synapse Analytics offers various analytics engines to help you ingest, transform, model, analyze, and distribute your data. An Apache Spark pool provides open-source big data compute capabilities. After you've created an Apache Spark pool in your Synapse workspace, data can be loaded, modeled, processed, and distributed for faster analytic insight.
+Azure Synapse Analytics offers various analytics engines to help you ingest, transform, model, analyze, and distribute your data. An Apache Spark pool provides open-source big data compute capabilities. After you create an Apache Spark pool in your Synapse workspace, data can be loaded, modeled, processed, and distributed for faster analytic insight.
 
 In this quickstart, you learn how to use the Azure portal to create an Apache Spark pool in a Synapse workspace.
 
@@ -25,78 +26,80 @@ If you don't have an Azure subscription, [create a free account before you begin
 ## Prerequisites
 
 - You'll need an Azure subscription. If needed, [create a free Azure account](https://azure.microsoft.com/free/)
-- [Synapse Analytics workspace](quickstart-create-workspace.md)
+- You'll be using the [Synapse workspace](./quickstart-create-workspace.md).
 
 ## Sign in to the Azure portal
 
 Sign in to the [Azure portal](https://portal.azure.com/)
 
-## Navigate to the Synapse workspace 
-1. Navigate to the Synapse workspace where the Apache Spark pool will be created by typing the service name (or resource name directly) into the search bar.
+## Navigate to the Synapse workspace
 
-    ![Azure portal search bar with Synapse workspaces typed in.](media/quickstart-create-sql-pool/create-sql-pool-00a.png)
+1. Navigate to the Synapse workspace where the Apache Spark pool will be created by typing the service name (or resource name directly) into the search bar.
+    :::image type="content" source="media/quickstart-create-sql-pool/create-sql-pool-00a.png" alt-text="Screenshot of the Azure portal search bar with Synapse workspaces typed in." lightbox="media/quickstart-create-sql-pool/create-sql-pool-00a.png":::
 
-1. From the list of workspaces, type the name (or part of the name) of the workspace to open. For this example, we'll use a workspace named **contosoanalytics**.
-![Listing of Synapse workspaces filtered to show those containing the name Contoso.](media/quickstart-create-sql-pool/create-sql-pool-00b.png)
+1. From the list of workspaces, type the name (or part of the name) of the workspace to open. For this example, we use a workspace named **contosoanalytics**.
+    :::image type="content" source="media/quickstart-create-sql-pool/create-sql-pool-00b.png" alt-text="Screenshot from the Azure portal of the list of Synapse workspaces filtered to show those containing the name Contoso." lightbox="media/quickstart-create-sql-pool/create-sql-pool-00b.png":::
 
 
 ## Create new Apache Spark pool
 
 > [!IMPORTANT]
-> Azure Synapse Runtime for Apache Spark 2.4 has been deprecated and officially not supported since 09/29/2023. Given [Spark 3.1](/azure/synapse-analytics/spark/apache-spark-3-runtime) and [Spark 3.2](/azure/synapse-analytics/spark/apache-spark-32-runtime) are also End of Life announced (EOLA), we recommend customers migrate to Spark 3.3. Please refer to [this link](/azure/synapse-analytics/spark/apache-spark-33-runtime) for a migration guide.
-1. In the Synapse workspace where you want to create the Apache Spark pool, select **New Apache Spark pool**.
-![Overview of Synapse workspace with a red box around the command to create a new Apache Spark pool](media/quickstart-create-apache-spark-pool/create-spark-pool-portal-01.png)
+> Azure Synapse Runtime for Apache Spark 2.4 has been deprecated and officially not supported since September 2023. Given [Spark 3.1](/azure/synapse-analytics/spark/apache-spark-3-runtime) and [Spark 3.2](/azure/synapse-analytics/spark/apache-spark-32-runtime) are also End of Support announced, [we recommend customers migrate to Spark 3.3](/azure/synapse-analytics/spark/apache-spark-33-runtime).
+
+1. In the Synapse workspace where you want to create the Apache Spark pool, select **New Apache Spark pool**. 
+   :::image type="content" source="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-01.png" alt-text="Screenshot from the Azure portal of a Synapse workspace with a red box around the command to create a new Apache Spark pool." lightbox="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-01.png":::
+
 1. Enter the following details in the **Basics** tab:
 
  |Setting | Suggested value | Description |
  | :------ | :-------------- | :---------- |
- | **Apache Spark pool name** | A valid pool name | This is the name that the Apache Spark pool will have. |
+ | **Apache Spark pool name** | A valid pool name, like `contosospark` | This is the name that the Apache Spark pool will have. |
  | **Node size** | Small (4 vCPU / 32 GB) | Set this to the smallest size to reduce costs for this quickstart |
  | **Autoscale** | Disabled | We don't need autoscale for this quickstart |
  | **Number of nodes** | 5 | Use a small size to limit costs for this quickstart |
 
-
-    ![Apache Spark pool create flow - basics tab.](media/quickstart-create-apache-spark-pool/create-spark-pool-portal-02.png)
+    :::image type="content" source="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-02.png" alt-text="Screenshot from the Azure portal of the Apache Spark pool create flow - basics tab." lightbox="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-02.png":::
 
-       > [!IMPORTANT]
-    > Note that there are specific limitations for the names that Apache Spark pools can use. Names must contain letters or numbers only, must be 15 or less characters, must start with a letter, not contain reserved words, and be unique in the workspace.
+    > [!IMPORTANT]
+    > There are specific limitations for the names that Apache Spark pools can use. Names must contain letters or numbers only, must be 15 or less characters, must start with a letter, not contain reserved words, and be unique in the workspace.
 
-1. Select **Next: additional settings** and review the default settings. Do not modify any default settings.
-![Screenshot that shows the "Create Apache Spark pool" page with the "Additional settings" tab selected.](media/quickstart-create-apache-spark-pool/create-spark-pool-portal-03.png)
+1. Select **Next: additional settings** and review the default settings. Don't modify any default settings.
+    :::image type="content" source="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-03.png" alt-text="Screenshot from the Azure portal that shows the 'Create Apache Spark pool' page with the 'Additional settings' tab selected." lightbox="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-03.png":::
 
-1. Select **Next: tags**. Don't add any tags.
-![Apache Spark pool create flow - additional settings tab.](media/quickstart-create-apache-spark-pool/create-spark-pool-03-tags.png)
+1. Select **Next: tags**. Consider using Azure tags. For example, the "Owner" or "CreatedBy" tag to identify who created the resource, and the "Environment" tag to identify whether this resource is in Production, Development, etc. For more information, see [Develop your naming and tagging strategy for Azure resources](/azure/cloud-adoption-framework/ready/azure-best-practices/naming-and-tagging).
+    :::image type="content" source="media/quickstart-create-apache-spark-pool/create-spark-pool-03-tags.png" alt-text="Screenshot from the Azure portal of Apache Spark pool create flow - additional settings tab." lightbox="media/quickstart-create-apache-spark-pool/create-spark-pool-03-tags.png":::
 
-5. Select **Review + create**.
+1. Select **Review + create**.
 
 1. Make sure that the details look correct based on what was previously entered, and select **Create**.
-![Apache Spark pool create flow - review settings tab.](media/quickstart-create-apache-spark-pool/create-spark-pool-portal-05.png)
+    :::image type="content" source="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-05.png" alt-text="Screenshot from the Azure portal of Apache Spark pool create flow - review settings tab." lightbox="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-05.png":::
 
 1. At this point, the resource provisioning flow will start, indicating once it's complete.
-![Screenshot that shows the "Overview" page with a "Your deployment is complete" message displayed.](media/quickstart-create-apache-spark-pool/create-spark-pool-portal-06.png)
+    :::image type="content" source="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-06.png" alt-text="Screenshot from the Azure portal of that shows the 'Overview' page with a 'Your deployment is complete' message displayed." lightbox="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-06.png":::
 
 1. After the provisioning completes, navigating back to the workspace will show a new entry for the newly created Apache Spark pool.
-![Apache Spark pool create flow - resource provisioning.](media/quickstart-create-apache-spark-pool/create-spark-pool-portal-07.png)
+    :::image type="content" source="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-07.png" alt-text="Screenshot from the Azure portal of Apache Spark pool create flow - resource provisioning." lightbox="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-07.png":::
 
-9. At this point, there are no resources running, no charges for Spark, you have created metadata about the Spark instances you want to create.
+1. At this point, there are no resources running, no charges for Spark, you have created metadata about the Spark instances you want to create.
 
 ## Clean up resources
 
-Follow the steps below to delete the Apache Spark pool from the workspace.
+The following steps delete the Apache Spark pool from the workspace.
+
 > [!WARNING]
 > Deleting an Apache Spark pool will remove the analytics engine from the workspace. It will no longer be possible to connect to the pool, and all queries, pipelines, and notebooks that use this Apache Spark pool will no longer work.
 
-If you want to delete the Apache Spark pool, do the following:
+If you want to delete the Apache Spark pool, do the following steps:
 
-1. Navigate to the Apache Spark pools blade in the workspace.
-2. Select the Apache Spark pool to be deleted (in this case, **contosospark**).
-1. Press **delete**.
-![Listing of Apache Spark pools, with the recently created pool selected.](media/quickstart-create-apache-spark-pool/create-spark-pool-portal-08.png)
-1. Confirm the deletion, and press **Delete** button.
-![Confirmation dialog to delete the selected Apache Spark pool.](media/quickstart-create-apache-spark-pool/create-spark-pool-portal-10.png)
-5. When the process completes successfully, the Apache Spark pool will no longer be listed in the workspace resources.
+1. Navigate to the Apache Spark pools pane in the workspace.
+1. Select the Apache Spark pool to be deleted (in this case, **contosospark**).
+1. Select **Delete**.
+    :::image type="content" source="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-08.png" alt-text="Screenshot from the Azure portal of a list of Apache Spark pools, with the recently created pool selected." lightbox="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-08.png":::
+1. Confirm the deletion, and select **Delete** button.
+    :::image type="content" source="media/quickstart-create-apache-spark-pool/create-spark-pool-portal-10.png" alt-text="Screenshot from the Azure portal of the Confirmation dialog to delete the selected Apache Spark pool.":::
+1. When the process completes successfully, the Apache Spark pool will no longer be listed in the workspace resources.
 
-## Next steps
+## Related content
 
-- See [Quickstart: Create an Apache Spark notebook](quickstart-apache-spark-notebook.md).
-- See [Quickstart: Create a dedicated SQL pool using the Azure portal](quickstart-create-sql-pool-portal.md).
+- [Quickstart: Create a serverless Apache Spark pool in Azure Synapse Analytics using web tools](quickstart-apache-spark-notebook.md)
+- [Quickstart: Create a dedicated SQL pool using the Azure portal](quickstart-create-sql-pool-portal.md)