Skip to content

Commit 9df7cad

Browse files
20230222 quickstart coverage, refresh
1 parent 053c88e commit 9df7cad

File tree

9 files changed

+129
-47
lines changed

9 files changed

+129
-47
lines changed
Loading
Loading
Loading
Lines changed: 24 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,29 @@
11
---
2-
title: 'Quickstart: Scale compute for Synapse SQL pool (Azure portal)'
3-
description: You can scale compute for Synapse SQL pool (data warehouse) using the Azure portal.
2+
title: "Quickstart: Scale compute for an Azure Synapse dedicated SQL pool (formerly SQL DW) with the Azure portal"
3+
description: You can scale compute for an Azure Synapse dedicated SQL pool (formerly SQL DW) with the Azure portal.
44
author: kedodd
55
ms.author: kedodd
66
manager: craigg
77
ms.reviewer: sngun
8-
ms.date: 03/09/2022
9-
ms.topic: quickstart
8+
ms.date: 02/22/2023
109
ms.service: synapse-analytics
1110
ms.subservice: sql-dw
12-
ms.custom: seo-lt-2019, azure-synapse, mode-ui
11+
ms.topic: quickstart
12+
ms.custom:
13+
- azure-synapse
14+
- mode-ui
1315
---
1416

15-
# Quickstart: Scale compute for Synapse SQL pool with the Azure portal
17+
# Quickstart: Scale compute for an Azure Synapse dedicated SQL pool (formerly SQL DW) with the Azure portal
18+
19+
You can scale compute for an Azure Synapse dedicated SQL pool (formerly SQL DW) with the Azure portal. [Scale out compute](sql-data-warehouse-manage-compute-overview.md) for better performance, or scale back compute to save costs.
1620

17-
You can scale compute for Synapse SQL pool (data warehouse) using the Azure portal. [Scale out compute](sql-data-warehouse-manage-compute-overview.md) for better performance, or scale back compute to save costs.
21+
If you don't have an Azure subscription, create a [free Azure account](https://azure.microsoft.com/free/) before you begin.
22+
23+
> [!NOTE]
24+
> This article applies to dedicated SQL pools (formerly SQL DW). This content does not apply to dedicated SQL pools in an Azure Synapse Analytics workspace. For similar instructions for dedicated SQL pools (formerly SQL DW), see [Quickstart: Scale compute for an Azure Synapse dedicated SQL pool in a Synapse workspace with the Azure portal](quickstart-scale-compute-workspace-portal.md).
25+
> For more on the differences between dedicated SQL pools (formerly SQL DW) and dedicated SQL pools in Azure Synapse Workspaces, read [What's the difference between Azure Synapse (formerly SQL DW) and Azure Synapse Analytics Workspace](https://techcommunity.microsoft.com/t5/azure-synapse-analytics-blog/what-s-the-difference-between-azure-synapse-formerly-sql-dw-and/ba-p/3597772).
1826
19-
If you don't have an Azure subscription, create a [free](https://azure.microsoft.com/free/) account before you begin.
2027

2128
## Sign in to the Azure portal
2229

@@ -26,8 +33,8 @@ Sign in to the [Azure portal](https://portal.azure.com/).
2633

2734
You can scale a SQL pool that you already have or use [Quickstart: create and connect - portal](create-data-warehouse-portal.md) to create a SQL pool named `mySampleDataWarehouse`. This quickstart scales `mySampleDataWarehouse`.
2835

29-
>[!IMPORTANT]
30-
>Your SQL pool must be online to scale.
36+
> [!IMPORTANT]
37+
> Your SQL pool must be online to scale.
3138
3239
## Scale compute
3340

@@ -36,14 +43,15 @@ SQL pool compute resources can be scaled by increasing or decreasing data wareho
3643
To change data warehouse units:
3744

3845
1. Select **Azure Synapse Analytics (formerly SQL DW)** in the left page of the Azure portal.
39-
2. Select `mySampleDataWarehouse` from the **Azure Synapse Analytics (formerly SQL DW)** page. The SQL pool opens.
40-
3. Select **Scale**.
46+
1. Select `mySampleDataWarehouse` from the **Azure Synapse Analytics (formerly SQL DW)** page. The SQL pool opens.
47+
1. Select **Scale**.
4148

42-
![Click Scale](./media/quickstart-scale-compute-portal/click-scale.png)
49+
:::image type="content" source="./media/quickstart-scale-compute-portal/scale-dedicated-sql-pool-azure-portal.png" alt-text="A screenshot of the Azure portal showing the Scale button on the Overview page of a dedicated sql pool (formerly SQL DW)." lightbox="./media/quickstart-scale-compute-portal/scale-dedicated-sql-pool-azure-portal.png":::
4350

44-
2. In the Scale panel, move the slider left or right to change the DWU setting. Then select scale.
51+
1. In the Scale panel, move the slider left or right to change the DWU setting. Then select scale.
4552

46-
![Move Slider](./media/quickstart-scale-compute-portal/scale-dwu.png)
53+
:::image type="content" source="./media/quickstart-scale-compute-portal/scale-dwu.png" alt-text="A screenshot of the Azure portal showing the scale slider.":::
4754

4855
## Next steps
49-
To learn more about SQL pool, continue to the [Load data into SQL pool](./load-data-from-azure-blob-storage-using-copy.md) tutorial.
56+
57+
- To learn more about SQL pool, continue to the [Load data into SQL pool](./load-data-from-azure-blob-storage-using-copy.md) tutorial.

articles/synapse-analytics/sql-data-warehouse/quickstart-scale-compute-tsql.md

Lines changed: 39 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,54 +1,63 @@
11
---
2-
title: 'Quickstart: Scale compute in dedicated SQL pool (formerly SQL DW) - T-SQL'
2+
title: "Quickstart: Scale compute in dedicated SQL pool (formerly SQL DW) - T-SQL"
33
description: Scale compute in dedicated SQL pool (formerly SQL DW) using T-SQL and SQL Server Management Studio (SSMS). Scale out compute for better performance, or scale back compute to save costs.
44
author: kedodd
55
ms.author: kedodd
66
manager: craigg
7+
ms.reviewer: wiassaf
8+
ms.date: 02/22/2023
79
ms.service: synapse-analytics
8-
ms.topic: quickstart
910
ms.subservice: sql-dw
10-
ms.date: 03/09/2022
11-
ms.reviewer: wiassaf
12-
ms.custom: seo-lt-2019, azure-synapse, mode-other
11+
ms.topic: quickstart
12+
ms.custom:
13+
- azure-synapse
14+
- mode-other
1315
---
1416

1517
# Quickstart: Scale compute for dedicated SQL pool (formerly SQL DW) in Azure Synapse Analytics using T-SQL
1618

17-
Scale compute in dedicated SQL pool (formerly SQL DW) using T-SQL and SQL Server Management Studio (SSMS). [Scale out compute](sql-data-warehouse-manage-compute-overview.md) for better performance, or scale back compute to save costs.
19+
Scale compute in dedicated SQL pools using T-SQL and SQL Server Management Studio (SSMS). [Scale out compute](sql-data-warehouse-manage-compute-overview.md) for better performance, or scale back compute to save costs.
1820

19-
If you don't have an Azure subscription, create a [free](https://azure.microsoft.com/free/) account before you begin.
21+
If you don't have an Azure subscription, create a [free Azure account](https://azure.microsoft.com/free/) before you begin.
22+
23+
> [!NOTE]
24+
> This article applies to dedicated SQL pools created in Azure Synapse Analytics workspaces, dedicated SQL pools (formerly SQL DW), and dedicated SQL pools (formerly SQL DW) in connected workspaces.
2025
2126
## Before you begin
2227

2328
Download and install the newest version of [SQL Server Management Studio](/sql/ssms/download-sql-server-management-studio-ssms?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest&preserve-view=true) (SSMS).
2429

25-
## Create a dedicated SQL pool (formerly SQL DW)
30+
## Create a dedicated SQL pool if needed
31+
32+
This quickstart assumes you already have a dedicated SQL pool.
33+
34+
If needed, it is recommended to created a new dedicated SQL pool in an Azure Synapse workspace. [Create an Azure Synapse workspace](../quickstart-create-workspace.md) and then [create a dedicated SQL pool using Synapse Studio](../quickstart-create-sql-pool-studio.md). Or, you can create a legacy dedicated SQL pool (formerly SQL DW), using [Quickstart: create and Connect - portal](create-data-warehouse-portal.md) to create a dedicated SQL pool (formerly SQL DW) named `mySampleDataWarehouse`.
2635

27-
Use [Quickstart: create and Connect - portal](create-data-warehouse-portal.md) to create a dedicated SQL pool (formerly SQL DW) named `mySampleDataWarehouse`. Complete the quickstart to ensure you have a firewall rule and can connect to your dedicated SQL pool (formerly SQL DW) from within SQL Server Management Studio.
36+
Ensure you have a firewall rule and can connect to your dedicated SQL pool from within SQL Server Management Studio (SSMS).
2837

2938
## Connect to the server as server admin
3039

3140
This section uses [SQL Server Management Studio](/sql/ssms/download-sql-server-management-studio-ssms?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest&preserve-view=true) (SSMS) to establish a connection to your Azure SQL server.
3241

3342
1. Open SQL Server Management Studio.
3443

35-
2. In the **Connect to Server** dialog box, enter the following information:
44+
1. In the **Connect to Server** dialog box, enter the following information:
3645

37-
| Setting       | Suggested value | Description |
38-
| ------------ | ------------------ | ------------------------------------------------- |
46+
| Setting       | Suggested value | Description  |
47+
| --- | --- | --- |
3948
| Server type | Database engine | This value is required |
4049
| Server name | The fully qualified server name | Here's an example: **mySampleDataWarehouseservername.database.windows.net**. |
4150
| Authentication | SQL Server Authentication | SQL Authentication is the only authentication type that is configured in this tutorial. |
4251
| Login | The server admin account | The account that you specified when you created the server. |
4352
| Password | The password for your server admin account | The password you specified when you created the server. |
4453

45-
![Connect to server](./media/quickstart-scale-compute-tsql/connect-to-server.png)
54+
:::image type="content" source="./media/quickstart-scale-compute-tsql/connect-to-server.png" alt-text="A screenshot from SQL Server Management Studio to connect to the dedicated SQL pool.":::
4655

47-
3. Select **Connect**. The Object Explorer window opens in SSMS.
56+
1. Select **Connect**. The Object Explorer window opens in SSMS.
4857

49-
4. In Object Explorer, expand **Databases**. Then expand `mySampleDataWarehouse` to view the objects in your new database.
58+
1. In Object Explorer, expand **Databases**. Then expand `mySampleDataWarehouse` to view the objects in your new database.
5059

51-
![Database objects](./media/quickstart-scale-compute-tsql/connected.png)
60+
:::image type="content" source="./media/quickstart-scale-compute-tsql/connected.png" alt-text="A screenshot from SQL Server Management Studio Object Explorer showing database objects.":::
5261

5362
## View service objective
5463

@@ -57,25 +66,25 @@ The service objective setting contains the number of data warehouse units for th
5766
To view the current data warehouse units for your dedicated SQL pool (formerly SQL DW):
5867

5968
1. Under the connection to `mySampleDataWarehouseservername.database.windows.net`, expand **System Databases**.
60-
2. Right-click on the `master` system database and select **New Query**. A new query window opens.
61-
3. Run the following query to select from the `sys.database_service_objectives` dynamic management view.
69+
1. Right-click on the `master` system database and select **New Query**. A new query window opens.
70+
1. Run the following query to select from the `sys.database_service_objectives` dynamic management view.
6271

6372
```sql
6473
SELECT
65-
db.name [Database]
66-
, ds.edition [Edition]
67-
, ds.service_objective [Service Objective]
74+
db.name AS [Database]
75+
, ds.edition AS [Edition]
76+
, ds.service_objective AS [Service Objective]
6877
FROM
6978
sys.database_service_objectives ds
7079
JOIN
7180
sys.databases db ON ds.database_id = db.database_id
7281
WHERE
73-
db.name = 'mySampleDataWarehouse'
82+
db.name = 'mySampleDataWarehouse';
7483
```
7584

76-
4. The following results show `mySampleDataWarehouse` has a service objective of DW400.
85+
1. The following results show `mySampleDataWarehouse` has a service objective of DW400 in the `Service Objective` column.
7786

78-
![iew-current-dwu](./media/quickstart-scale-compute-tsql/view-current-dwu.png)
87+
:::image type="content" source="./media/quickstart-scale-compute-tsql/view-current-dwu.png" alt-text="A screenshot from SQL Server Management Studio results set showing the current DWU in the Service Objective column .":::
7988

8089
## Scale compute
8190

@@ -84,7 +93,7 @@ In dedicated SQL pool (formerly SQL DW), you can increase or decrease compute re
8493
To change data warehouse units:
8594

8695
1. Right-click on the `master` system database and select **New Query**.
87-
2. Use the [ALTER DATABASE](/sql/t-sql/statements/alter-database-azure-sql-database?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest&preserve-view=true) T-SQL statement to modify the service objective. Run the following query to change the service objective to DW300.
96+
1. Use the [ALTER DATABASE](/sql/t-sql/statements/alter-database-azure-sql-database?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest&preserve-view=true) T-SQL statement to modify the service objective. Run the following query to change the service objective to DW300.
8897

8998
```Sql
9099
ALTER DATABASE mySampleDataWarehouse
@@ -98,7 +107,7 @@ To see the progress of the previous change request, you can use the `WAITFORDELA
98107
To poll for the service object change status:
99108

100109
1. Right-click on the `master` system database and select **New Query**.
101-
2. Run the following query to poll the [sys.dm_operation_status](/sql/relational-databases/system-dynamic-management-views/sys-dm-operation-status-azure-sql-database?view=azure-sqldw-latest&preserve-view=true) DMV.
110+
1. Run the following query to poll the [sys.dm_operation_status](/sql/relational-databases/system-dynamic-management-views/sys-dm-operation-status-azure-sql-database?view=azure-sqldw-latest&preserve-view=true) DMV.
102111

103112
```sql
104113
WHILE
@@ -120,9 +129,9 @@ To poll for the service object change status:
120129
PRINT 'Complete';
121130
```
122131

123-
3. The resulting output shows a log of the polling of the status.
132+
1. The resulting output shows a log of the polling of the status.
124133

125-
![Operation status](./media/quickstart-scale-compute-tsql/polling-output.png)
134+
:::image type="content" source="./media/quickstart-scale-compute-tsql/polling-output.png" alt-text="A screenshot from SQL Server Management Studio showing the output of the query to monitor the dedicated SQL pool operation status. A series of 'Scale operation in progress' lines is displayed, ending with a line that says 'Complete'.":::
126135

127136
## Check dedicated SQL pool (formerly SQL DW) state
128137

@@ -139,12 +148,12 @@ FROM
139148
WHERE
140149
resource_type_desc = 'Database'
141150
AND
142-
major_resource_id = 'mySampleDataWarehouse'
151+
major_resource_id = 'mySampleDataWarehouse';
143152
```
144153
145154
## Next steps
146155
147156
You've now learned how to scale compute for your dedicated SQL pool (formerly SQL DW). To learn more about Azure Synapse Analytics, continue to the tutorial for loading data.
148157

149158
> [!div class="nextstepaction"]
150-
>[Load data into a dedicated SQL pool](./load-data-from-azure-blob-storage-using-copy.md)
159+
>[Load data into a dedicated SQL pool](./load-data-from-azure-blob-storage-using-copy.md)
Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
---
2+
title: "Quickstart: Scale compute for an Azure Synapse dedicated SQL pool in a Synapse workspace with the Azure portal"
3+
description: Learn how to scale compute for an Azure Synapse dedicated SQL pool in a Synapse workspace with the Azure portal.
4+
author: kedodd
5+
ms.author: kedodd
6+
manager: craigg
7+
ms.reviewer: sngun
8+
ms.date: 02/22/2023
9+
ms.service: synapse-analytics
10+
ms.subservice: sql-dw
11+
ms.topic: quickstart
12+
ms.custom:
13+
- azure-synapse
14+
- mode-ui
15+
---
16+
17+
# Quickstart: Scale compute for an Azure Synapse dedicated SQL pool in a Synapse workspace with the Azure portal
18+
19+
You can scale compute for an Azure Synapse dedicated SQL pool in a Synapse workspace using the Azure portal. [Scale out compute](sql-data-warehouse-manage-compute-overview.md) for better performance, or scale back compute to save costs.
20+
21+
If you don't have an Azure subscription, create a [free Azure account](https://azure.microsoft.com/free/) before you begin.
22+
23+
> [!NOTE]
24+
> This article applies to dedicated SQL pools created in Azure Synapse Analytics workspaces. This content does not apply to dedicated SQL pools (formerly SQL DW) or dedicated SQL pools (formerly SQL DW) in connected workspaces. For similar instructions for dedicated SQL pools (formerly SQL DW), see [Quickstart: Scale compute for an Azure Synapse dedicated SQL pool (formerly SQL DW) with the Azure portal](quickstart-scale-compute-portal.md).
25+
> For more on the differences between dedicated SQL pools (formerly SQL DW) and dedicated SQL pools in Azure Synapse Workspaces, read [What's the difference between Azure Synapse (formerly SQL DW) and Azure Synapse Analytics Workspace](https://techcommunity.microsoft.com/t5/azure-synapse-analytics-blog/what-s-the-difference-between-azure-synapse-formerly-sql-dw-and/ba-p/3597772).
26+
27+
## Sign in to the Azure portal
28+
29+
Sign in to the [Azure portal](https://portal.azure.com/).
30+
31+
## Before you begin
32+
33+
You can scale a SQL pool that you already have or use [Quickstart: create and connect - portal](create-data-warehouse-portal.md) to create a SQL pool named `mySampleDataWarehouse`. This quickstart scales `mySampleDataWarehouse`.
34+
35+
> [!IMPORTANT]
36+
> Your SQL pool must be online to scale.
37+
38+
## Scale compute
39+
40+
SQL pool compute resources can be scaled by increasing or decreasing data warehouse units. The [Quickstart: create and connect - portal](create-data-warehouse-portal.md) created `mySampleDataWarehouse` and initialized it with 400 DWUs. The following steps adjust the DWUs for `mySampleDataWarehouse`.
41+
42+
To change data warehouse units:
43+
44+
1. Select **Azure Synapse Analytics** in the left page of the Azure portal.
45+
1. Under **Analytical pools**, select **SQL pools** from the main menu.
46+
1. Select `mySampleDataWarehouse` from the list of pools. The SQL pool opens.
47+
1. Select **Scale** from the navigation menu.
48+
49+
:::image type="content" source="./media/quickstart-scale-compute-workspace-portal/scale-dedicated-sql-pool-azure-portal.png" alt-text="A screenshot of the Azure portal showing the Scale button on the Overview page of a dedicated SQL pool." lightbox="./media/quickstart-scale-compute-portal/scale-dedicated-sql-pool-azure-portal.png":::
50+
51+
1. In the **Scale** panel, move the slider left or right to change the DWU setting. Then select **Save**.
52+
53+
:::image type="content" source="./media/quickstart-scale-compute-workspace-portal/dedicated-sql-pool-scale-slider-azure-portal.png" alt-text="A screenshot of the Azure portal showing the Scale slider on the Scale page of a dedicated SQL pool in an Azure Synapse workspace." lightbox="./media/quickstart-scale-compute-portal/dedicated-sql-pool-scale-slider-azure-portal.png":::
54+
55+
## Next steps
56+
57+
- To learn more about SQL pool, continue to the [Load data into SQL pool](./load-data-from-azure-blob-storage-using-copy.md) tutorial.
58+
- [Quickstart: Scale compute for dedicated SQL pools in Azure Synapse Workspaces with Azure PowerShell](quickstart-scale-compute-workspace-powershell.md)

articles/synapse-analytics/sql-data-warehouse/quickstart-scale-compute-workspace-powershell.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,4 +124,5 @@ You have now learned how to scale compute for dedicated SQL pool in a Synapse wo
124124
> [Load data into a dedicated SQL pool](load-data-from-azure-blob-storage-using-copy.md)
125125
126126
- To get started with Azure Synapse Analytics, see [Get Started with Azure Synapse Analytics](../get-started.md).
127-
- To learn more about dedicated SQL pools in Azure Synapse Analytics, see [What is dedicated SQL pool (formerly SQL DW) in Azure Synapse Analytics?](sql-data-warehouse-overview-what-is.md)
127+
- To learn more about dedicated SQL pools in Azure Synapse Analytics, see [What is dedicated SQL pool (formerly SQL DW) in Azure Synapse Analytics?](sql-data-warehouse-overview-what-is.md)
128+
- [Quickstart: Scale compute for an Azure Synapse dedicated SQL pool in a Synapse workspace with the Azure portal](quickstart-scale-compute-workspace-portal.md)

articles/synapse-analytics/toc.yml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -290,6 +290,12 @@ items:
290290
displayName: sql pool
291291
- name: Workload management
292292
items:
293+
- name: Scale compute using the Azure portal
294+
href: ./sql-data-warehouse/quickstart-scale-compute-workspace-portal.md
295+
- name: Scale compute using PowerShell
296+
href: ./sql-data-warehouse/quickstart-scale-compute-workspace-powershell.md
297+
- name: Scale compute using T-SQL
298+
href: ./sql-data-warehouse/quickstart-scale-compute.md?context=/azure/synapse-analytics/context/context
293299
- name: Create workload classifier
294300
items:
295301
- name: Portal

0 commit comments

Comments
 (0)