Skip to content

Commit 126f513

Browse files
Merge pull request #228133 from WilliamDAssafMSFT/20230213-update-quickstart-scale-compute-powershell
20230213 update quickstart scale compute powershell
2 parents 64d359d + b9ace83 commit 126f513

16 files changed

+459
-206
lines changed
Lines changed: 32 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
2-
title: 'Quickstart: Create a dedicated SQL pool using Synapse Studio'
2+
title: "Quickstart: Create a dedicated SQL pool using Synapse Studio"
33
description: Create a dedicated SQL pool using Synapse Studio by following the steps in this guide.
44
author: WilliamDAssafMSFT
5-
ms.service: synapse-analytics
6-
ms.topic: quickstart
7-
ms.subservice: sql
8-
ms.date: 10/16/2020
95
ms.author: wiassaf
106
ms.reviewer: sngun
7+
ms.date: 02/21/2023
8+
ms.service: synapse-analytics
9+
ms.subservice: sql
10+
ms.topic: quickstart
1111
ms.custom: mode-ui
1212
---
1313

@@ -19,11 +19,10 @@ This quickstart describes the steps to create a dedicated SQL pool in a Synapse
1919

2020
If you don't have an Azure subscription, [create a free account before you begin](https://azure.microsoft.com/free/).
2121

22-
2322
## Prerequisites
2423

25-
- Azure subscription - [create one for free](https://azure.microsoft.com/free/)
26-
- [Synapse workspace](quickstart-create-workspace.md)
24+
- Azure subscription - [create an Azure account for free](https://azure.microsoft.com/free/)
25+
- [Azure Synapse workspace](quickstart-create-workspace.md)
2726

2827
## Sign in to the Azure portal
2928

@@ -33,79 +32,82 @@ Sign in to the [Azure portal](https://portal.azure.com/)
3332

3433
1. Navigate to the Synapse workspace where the dedicated SQL pool will be created by typing the service name (or resource name directly) into the search bar.
3534

36-
![Azure portal search bar with Synapse workspaces typed in.](media/quickstart-create-sql-pool/create-sql-pool-00a.png)
35+
:::image type="content" source="media/quickstart-create-sql-pool/create-sql-pool-00a.png" alt-text="A screenshot of the Azure portal search bar with Synapse workspaces typed in.":::
3736
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**.
3837

39-
![Listing of Synapse workspaces filtered to show those containing the name Contoso.](media/quickstart-create-sql-pool/create-sql-pool-00b.png)
38+
:::image type="content" source="media/quickstart-create-sql-pool/create-sql-pool-00b.png" alt-text="A screenshot of the Synapse workspaces filtered to show those containing the name Contoso.":::
4039

4140
## Launch Synapse Studio
4241

4342
1. From the workspace overview, select the **Workspace web URL** to launch Synapse Studio.
4443

45-
![Azure portal Synapse workspace overview with Workspace web URL highlighted.](media/quickstart-create-apache-spark-pool/create-spark-pool-studio-20.png)
44+
:::image type="content" source="media/quickstart-create-apache-spark-pool/create-spark-pool-studio-20.png" alt-text="A screenshot of the Azure portal Synapse workspace overview with Workspace web URL highlighted.":::
4645

4746
## Create a dedicated SQL pool in Synapse Studio
4847

4948
1. On the Synapse Studio home page, navigate to the **Management Hub** in the left navigation by selecting the **Manage** icon.
5049

51-
![Synapse Studio home page with Management Hub section highlighted.](media/quickstart-create-apache-spark-pool/create-spark-pool-studio-21.png)
50+
:::image type="content" source="media/quickstart-create-apache-spark-pool/create-spark-pool-studio-21.png" alt-text="A screenshot of the Synapse Studio home page with Management Hub section highlighted.":::
5251

5352
1. Once in the Management Hub, navigate to the **SQL pools** section to see the current list of SQL pools that are available in the workspace.
5453

55-
![Synapse Studio management hub with SQL pools navigation selected](media/quickstart-create-sql-pool/create-sql-pool-studio-22.png)
54+
:::image type="content" source="media/quickstart-create-sql-pool/create-sql-pool-studio-22.png" alt-text="A screenshot of the Synapse Studio management hub with SQL pools navigation selected.":::
5655

57-
1. Select **+ New** command and the new SQL pool create wizard will appear.
56+
1. Select **+ New** command and the new SQL pool create wizard will appear.
5857

59-
![Synapse Studio Management Hub listing of SQL pools.](media/quickstart-create-sql-pool/create-sql-pool-studio-23.png)
58+
:::image type="content" source="media/quickstart-create-sql-pool/create-sql-pool-studio-23.png" alt-text="A screenshot of the Synapse Studio Management Hub listing of SQL pools.":::
6059

6160
1. Enter the following details in the **Basics** tab:
6261

63-
| Setting | Suggested value | Description |
64-
| :------ | :-------------- | :---------- |
65-
| **SQL pool name** | contosoedw | This is the name that the dedicated SQL pool will have. |
62+
| Setting | Suggested value | Description  |
63+
| :--- | :--- | :--- |
64+
| **SQL pool name** | `contosoedw` | This is the name that the dedicated SQL pool will have. |
6665
| **Performance level** | DW100c | Set this to the smallest size to reduce costs for this quickstart |
6766

68-
![SQL pools create flow - basics tab.](media/quickstart-create-sql-pool/create-sql-pool-studio-24.png)
69-
> [!IMPORTANT]
67+
:::image type="content" source="media/quickstart-create-sql-pool/create-sql-pool-studio-24.png" alt-text="A screenshot of the SQL pools create flow - basics tab.":::
68+
69+
> [!IMPORTANT]
7070
> Note that there are specific limitations for the names that dedicated SQL pools can use. Names can't contain special characters, must be 60 or less characters, not contain reserved words, and be unique in the workspace.
7171
72-
4. In the next tab, **Additional settings**, select **none** to provision the SQL pool without data. Leave the default collation as selected.
72+
1. In the next tab, **Additional settings**, select **none** to create the dedicated SQL pool without data. Leave the default collation as selected.
7373

7474
If you want to restore your dedicated SQL pool from a restore point, select **Restore point**. For more information on how to perform a restore, see [How-to: Restore an existing dedicated SQL pool](backuprestore/restore-sql-pool.md)
7575

76-
![SQL pool create flow - additional settings tab.](media/quickstart-create-sql-pool/create-sql-pool-studio-25.png)
76+
:::image type="content" source="media/quickstart-create-sql-pool/create-sql-pool-studio-25.png" alt-text="A screenshot of the SQL pool create flow - additional settings tab.":::
7777

7878
1. We won't add any tags for now, so next select **Review + create**.
7979

80-
1. In the **Review + create** tab, make sure that the details look correct based on what was previously entered, and press **create**.
80+
1. In the **Review + create** tab, make sure that the details look correct based on what was previously entered, and press **Create**.
8181

82-
![SQL pool create flow - review settings tab.](media/quickstart-create-sql-pool/create-sql-pool-studio-26.png)
82+
:::image type="content" source="media/quickstart-create-sql-pool/create-sql-pool-studio-26.png" alt-text="A screenshot of the SQL pool create flow - review settings tab.":::
8383

8484
1. At this point, the resource provisioning flow will start.
8585

8686
1. After the provisioning completes, navigating back to the workspace will show a new entry for the newly created SQL pool.
8787

88-
![SQL pool create flow - resource provisioning.](media/quickstart-create-sql-pool/create-sql-pool-studio-27.png)
88+
:::image type="content" source="media/quickstart-create-sql-pool/create-sql-pool-studio-27.png" alt-text="A screenshot of the SQL pool create flow - resource provisioning.":::
8989

9090
1. Once the dedicated SQL pool is created, it will be available in the workspace for loading data, processing streams, reading from the lake, etc.
9191

92-
## Clean up dedicated SQL pool using Synapse Studio
92+
## Clean up dedicated SQL pool using Synapse Studio
9393

9494
Follow the steps below to delete the dedicated SQL pool from the workspace using Synapse Studio.
95-
> [!WARNING]
95+
96+
> [!WARNING]
9697
> Deleting a dedicated SQL pool will remove the analytics engine from the workspace. It will no longer be possible to connect to the pool, and all queries, pipelines, scripts that use this dedicated SQL pool will no longer work.
9798
9899
If you want to delete the dedicated SQL pool, do the following:
99100

100101
1. Navigate to the SQL pools in the Management Hub in Synapse Studio.
101102
1. Select the ellipsis in the dedicated SQL pool to be deleted (in this case, **contosoedw**) to show the commands for the dedicated SQL pool:
102103

103-
![Listing of SQL pools, with the recently created pool selected.](media/quickstart-create-sql-pool/create-sql-pool-studio-28.png)
104-
1. Press **delete**.
104+
:::image type="content" source="media/quickstart-create-sql-pool/create-sql-pool-studio-28.png" alt-text="A screenshot of all SQL pools, with the recently created pool selected.":::
105+
1. Press **Delete**.
105106
1. Confirm the deletion, and press **Delete** button.
106107
1. When the process completes successfully, the dedicated SQL pool will no longer be listed in the workspace resources.
107108

108109
## Next steps
109-
110+
110111
- See [Quickstart: Create an Apache Spark notebook](quickstart-apache-spark-notebook.md).
111112
- See [Quickstart: Create a dedicated SQL pool using the Azure portal](quickstart-create-sql-pool-portal.md).
113+
- See [Quickstart: Scale compute for dedicated SQL pools in Azure Synapse Workspaces with Azure PowerShell](sql-data-warehouse/quickstart-scale-compute-workspace-powershell.md)

0 commit comments

Comments
 (0)