Skip to content

Commit d35a4f0

Browse files
authored
Merge pull request #115420 from Kat-Campise/sql_analytics_naming2
SQL analytics edits 2
2 parents b1313ba + bb927dc commit d35a4f0

7 files changed

+29
-29
lines changed

articles/synapse-analytics/sql-data-warehouse/sql-data-warehouse-concept-resource-utilization-query-activity.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,11 @@ ms.custom: azure-synapse
1515

1616
# Monitoring resource utilization and query activity in Azure Synapse Analytics
1717

18-
Azure Synapse Analytics provides a rich monitoring experience within the Azure portal to surface insights regarding your data warehouse workload. The Azure portal is the recommended tool when monitoring your data warehouse as it provides configurable retention periods, alerts, recommendations, and customizable charts and dashboards for metrics and logs. The portal also enables you to integrate with other Azure monitoring services such as Azure Monitor (logs) with Log analytics to provide a holistic monitoring experience for not only your data warehouse but also your entire Azure analytics platform for an integrated monitoring experience. This documentation describes what monitoring capabilities are available to optimize and manage your analytics platform with SQL Analytics.
18+
Azure Synapse Analytics provides a rich monitoring experience within the Azure portal to surface insights regarding your data warehouse workload. The Azure portal is the recommended tool when monitoring your data warehouse as it provides configurable retention periods, alerts, recommendations, and customizable charts and dashboards for metrics and logs. The portal also enables you to integrate with other Azure monitoring services such as Azure Monitor (logs) with Log analytics to provide a holistic monitoring experience for not only your data warehouse but also your entire Azure analytics platform for an integrated monitoring experience. This documentation describes what monitoring capabilities are available to optimize and manage your analytics platform with Synapse SQL.
1919

2020
## Resource utilization
2121

22-
The following metrics are available in the Azure portal for SQL Analytics. These metrics are surfaced through [Azure Monitor](../../azure-monitor/platform/data-collection.md?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json#metrics).
22+
The following metrics are available in the Azure portal for Synapse SQL. These metrics are surfaced through [Azure Monitor](../../azure-monitor/platform/data-collection.md?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json#metrics).
2323

2424
| Metric Name | Description | Aggregation Type |
2525
| ----------------------- | ------------------------------------------------------------ | ---------------- |
@@ -49,13 +49,13 @@ Things to consider when viewing metrics and setting alerts:
4949

5050
## Query activity
5151

52-
For a programmatic experience when monitoring SQL Analytics via T-SQL, the service provides a set of Dynamic Management Views (DMVs). These views are useful when actively troubleshooting and identifying performance bottlenecks with your workload.
52+
For a programmatic experience when monitoring Synapse SQL via T-SQL, the service provides a set of Dynamic Management Views (DMVs). These views are useful when actively troubleshooting and identifying performance bottlenecks with your workload.
5353

5454
To view the list of DMVs that apply to Synapse SQL, refer to this [documentation](../sql/reference-tsql-system-views.md#sql-pool-dynamic-management-views-dmvs).
5555

5656
## Metrics and diagnostics logging
5757

58-
Both metrics and logs can be exported to Azure Monitor, specifically the [Azure Monitor logs](../../azure-monitor/log-query/log-query-overview.md?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json) component and can be programmatically accessed through [log queries](../../azure-monitor/log-query/get-started-portal.md?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json). The log latency for SQL Analytics is about 10-15 minutes. For more details on the factors impacting latency, visit the following documentation.
58+
Both metrics and logs can be exported to Azure Monitor, specifically the [Azure Monitor logs](../../azure-monitor/log-query/log-query-overview.md?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json) component and can be programmatically accessed through [log queries](../../azure-monitor/log-query/get-started-portal.md?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json). The log latency for Synapse SQL is about 10-15 minutes. For more details on the factors impacting latency, visit the following documentation.
5959

6060
## Next steps
6161

articles/synapse-analytics/sql-data-warehouse/sql-data-warehouse-load-from-azure-data-lake-store.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.reviewer: igorstan
1313
ms.custom: azure-synapse
1414
---
1515

16-
# Load data from Azure Data Lake Storage for SQL Analytics
16+
# Load data from Azure Data Lake Storage for Synapse SQL
1717

1818
This guide outlines how to use PolyBase external tables to load data from Azure Data Lake Storage. Although you can run adhoc queries on data stored in Data Lake Storage, we recommend importing the data for best performance.
1919

articles/synapse-analytics/sql-data-warehouse/sql-data-warehouse-overview-integrate.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,16 +13,16 @@ ms.reviewer: igorstan
1313
ms.custom: seo-lt-2019
1414
---
1515

16-
# Integrate other services with a SQL Analytics data warehouse
16+
# Integrate other services with a Synapse SQL pool (data warehouse)
1717

18-
The SQL Analytics capability within Azure Synapse Analytics enables users to integrate with many of the other services in Azure. Using SQL Analytics, you can create a data warehouse via its SQL pool resource, which can then utilize several additional services, some of which include:
18+
The SQL pool capability within Azure Synapse Analytics enables users to integrate with many of the other services in Azure. Using Synapse SQL, you can create a data warehouse via its SQL pool resource, which can then utilize several additional services, some of which include:
1919

2020
* Power BI
2121
* Azure Data Factory
2222
* Azure Machine Learning
2323
* Azure Stream Analytics
2424

25-
For more information regarding integration services across Azure, review the [Integration partners](sql-data-warehouse-partner-data-integration.md)article.
25+
For more information about integration services across Azure, review the [Integration partners](sql-data-warehouse-partner-data-integration.md)article.
2626

2727
## Power BI
2828

articles/synapse-analytics/sql-data-warehouse/sql-data-warehouse-tables-temporary.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Temporary tables are only visible to the session in which they were created and
2424

2525
Temporary tables offer a performance benefit because their results are written to local rather than remote storage.
2626

27-
Temporary tables are useful when processing data, especially during transformation where the intermediate results are transient. With SQL Analytics, temporary tables exist at the session level. They're only visible to the session in which they were created. As such, they're automatically dropped when that session logs off.
27+
Temporary tables are useful when processing data, especially during transformation where the intermediate results are transient. With SQL pool, temporary tables exist at the session level. They're only visible to the session in which they were created. As such, they're automatically dropped when that session logs off.
2828

2929
## Temporary tables in SQL pool
3030

@@ -228,5 +228,5 @@ Also, views can't be created on temporary tables. Temporary tables can only be
228228

229229
## Next steps
230230

231-
To learn more about developing tables, see the [Designing tables using the SQL Analytics resources](sql-data-warehouse-tables-overview.md) article.
231+
To learn more about developing tables, see the [Designing tables using the Synapse SQL resources](sql-data-warehouse-tables-overview.md) article.
232232

articles/synapse-analytics/sql-data-warehouse/sql-data-warehouse-troubleshoot-connectivity.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -13,40 +13,40 @@ ms.reviewer: igorstan
1313
ms.custom: seo-lt-2019, azure-synapse
1414
---
1515

16-
# Troubleshooting connectivity issues
16+
# Troubleshooting connectivity issues in Synapse SQL pool
1717

18-
This article lists common troubleshooting techniques around connecting to your SQL Analytics database.
18+
This article lists common troubleshooting techniques around connecting to your SQL pool database.
1919

2020
## Check service availability
2121

22-
Check to see if the service is available. In the Azure portal, go to the Synapse SQL pool you're trying to connect. In the left TOC panel, click on **Diagnose and solve problems**.
22+
Check to see if the service is available. In the Azure portal, go to the SQL pool you're trying to connect. In the left TOC panel, click on **Diagnose and solve problems**.
2323

2424
![Select Resource health](./media/sql-data-warehouse-troubleshoot-connectivity/diagnostics-link.png)
2525

26-
The status of your Synapse SQL pool will be shown here. If the service isn't showing as **Available**, check further steps.
26+
The status of your SQL pool will be shown here. If the service isn't showing as **Available**, check further steps.
2727

2828
![Service Available](./media/sql-data-warehouse-troubleshoot-connectivity/resource-health.png)
2929

30-
If your Resource health shows that your Synapse SQL pool instance is paused or scaling, follow the guidance to resume your instance.
30+
If your Resource health shows that your SQL pool instance is paused or scaling, follow the guidance to resume your instance.
3131

3232
![Service Paused](./media/sql-data-warehouse-troubleshoot-connectivity/resource-health-pausing.png)
3333
Additional information about Resource Health can be found here.
3434

3535
## Check for paused or scaling operation
3636

37-
Check the portal to see if your Synapse SQL pool instance is paused or scaling.
37+
Check the portal to see if your SQL pool instance is paused or scaling.
3838

3939
![Service Paused](./media/sql-data-warehouse-troubleshoot-connectivity/overview-paused.png)
4040

41-
If you see that your service is paused or scaling, check to see it isn't during your maintenance schedule. On the portal for your Synapse SQL pool *Overview*, you'll see the elected maintenance schedule.
41+
If you see that your service is paused or scaling, check to see it isn't during your maintenance schedule. On the portal for your SQL pool *Overview*, you'll see the elected maintenance schedule.
4242

4343
![Overview Maintenance Schedule](./media/sql-data-warehouse-troubleshoot-connectivity/overview-maintance-schedule.png)
4444

45-
Otherwise, check with your IT administrator to verify that this maintenance isn't a scheduled event. To resume the SQL Analytics instance, follow [these steps](pause-and-resume-compute-portal.md).
45+
Otherwise, check with your IT administrator to verify that this maintenance isn't a scheduled event. To resume the SQL pool instance, follow [these steps](pause-and-resume-compute-portal.md).
4646

4747
## Check your firewall settings
4848

49-
SQL Analytics database communicates over port 1433.   If you're trying to connect from within a corporate network, outbound traffic over port 1433 might not be allowed by your network's firewall. In that case, you can't connect to your Azure SQL Database server unless your IT department opens port 1433. Additional information on firewall configurations can be found [here](../../sql-database/sql-database-firewall-configure.md?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json#create-and-manage-ip-firewall-rules).
49+
The SQL pool database communicates over port 1433.  If you're trying to connect from within a corporate network, outbound traffic over port 1433 might not be allowed by your network's firewall. In that case, you can't connect to your Azure SQL Database server unless your IT department opens port 1433. Additional information on firewall configurations can be found [here](../../sql-database/sql-database-firewall-configure.md?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json#create-and-manage-ip-firewall-rules).
5050

5151
## Check your VNet/Service Endpoint settings
5252

@@ -56,7 +56,7 @@ If you're receiving Errors 40914 and 40615, see [error description and resolutio
5656

5757
### Software
5858

59-
Check to make sure you're using the latest tools to connect to your Synapse SQL pool:
59+
Check to make sure you're using the latest tools to connect to your SQL pool:
6060

6161
- SSMS
6262
- Azure Data Studio
@@ -101,7 +101,7 @@ jdbc:sqlserver://yourserver.database.windows.net:1433;database=yourdatabase;user
101101

102102
## Intermittent connection issues
103103

104-
Check to see if you're experiencing heavy load on the server with a high number of queued requests. You may need to scale up your Synapse SQL pool for additional resources.
104+
Check to see if you're experiencing heavy load on the server with a high number of queued requests. You may need to scale up your SQL pool for additional resources.
105105

106106
## Common error messages
107107

articles/synapse-analytics/sql-data-warehouse/sql-data-warehouse-troubleshoot.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Troubleshooting
3-
description: Troubleshooting Azure Synapse Analytics.
2+
title: Troubleshooting
3+
description: Troubleshooting Synapse SQL in Azure Synapse Analytics.
44
services: synapse-analytics
55
author: kevinvngo
66
manager: craigg
@@ -13,9 +13,9 @@ ms.reviewer: jrasnick
1313
ms.custom: azure-synapse
1414
---
1515

16-
# Troubleshooting SQL Analytics in Azure Synapse
16+
# Troubleshooting Synapse SQL in Azure Synapse Analytics
1717

18-
This article lists common troubleshooting question.
18+
This article lists common troubleshooting issues in Synapse SQL.
1919

2020
## Connecting
2121

articles/synapse-analytics/sql-data-warehouse/sql-data-warehouse-workload-management.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ ms.custom: azure-synapse
1515

1616
# What is workload management?
1717

18-
Running mixed workloads can pose resource challenges on busy systems. Solution Architects seek ways to separate classic data warehousing activities (such as loading, transforming and querying data) to ensure that enough resources exist to hit SLAs.
18+
Running mixed workloads can pose resource challenges on busy systems. Solution Architects seek ways to separate classic data warehousing activities (such as loading, transforming, and querying data) to ensure that enough resources exist to hit SLAs.
1919

2020
Physical server isolation can lead to pockets of infrastructure that are underutilized, overbooked or in a state where caches are constantly being primed with hardware starting and stopping. A successful workload management scheme effectively manages resources, ensures highly efficient resource utilization, and maximizes return on investment (ROI).
2121

@@ -33,13 +33,13 @@ The performance capacity of a data warehouse is determined by the [data warehous
3333

3434
## Workload management concepts
3535

36-
In the past, for SQL Analytics in Azure Synapse you managed the query performance through [resource classes](resource-classes-for-workload-management.md). Resource classes allowed for assigning memory to a query based on role membership. The primary challenge with resources classes is that, once configured, there was no governance or ability to control the workload.
36+
In the past, for Synapse SQL in Azure Synapse you managed the query performance through [resource classes](resource-classes-for-workload-management.md). Resource classes allowed for assigning memory to a query based on role membership. The primary challenge with resources classes is that, once configured, there was no governance or ability to control the workload.
3737

3838
For example, granting an ad-hoc user role membership to smallrc allowed that user to consume 100% of the memory on the system. With resource classes, there is no way to reserve and ensure resources are available for critical workloads.
3939

40-
Synapse SQL pool workload management in Azure Synapse consists of three high-level concepts: [Workload Classification](sql-data-warehouse-workload-classification.md), [Workload Importance](sql-data-warehouse-workload-importance.md) and [Workload Isolation](sql-data-warehouse-workload-isolation.md). These capabilities give you more control over how your workload utilizes system resources.
40+
Synapse SQL pool workload management in Azure Synapse consists of three high-level concepts: [Workload Classification](sql-data-warehouse-workload-classification.md), [Workload Importance](sql-data-warehouse-workload-importance.md), and [Workload Isolation](sql-data-warehouse-workload-isolation.md). These capabilities give you more control over how your workload utilizes system resources.
4141

42-
Workload classification is the concept of assigning a request to a workload group and setting importance levels. Historically, this assignment was done via role membership using [sp_addrolemember](resource-classes-for-workload-management.md#change-a-users-resource-class). This can now be done via the [CREATE WORKLOAD CLASSIFER](/sql/t-sql/statements/create-workload-classifier-transact-sql?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest). The classification capability provides a richer set of options such as label, session, and time to classify requests.
42+
Workload classification is the concept of assigning a request to a workload group and setting importance levels. Historically, this assignment was done via role membership using [sp_addrolemember](resource-classes-for-workload-management.md#change-a-users-resource-class). This action can now be done via the [CREATE WORKLOAD CLASSIFER](/sql/t-sql/statements/create-workload-classifier-transact-sql?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest). The classification capability provides a richer set of options such as label, session, and time to classify requests.
4343

4444
Workload importance influences the order in which a request gets access to resources. On a busy system, a request with higher importance has first access to resources. Importance can also ensure ordered access to locks.
4545

0 commit comments

Comments
 (0)