Skip to content

Commit c2e74d2

Browse files
Merge pull request #290232 from whhender/article-type-updates
Article type updates
2 parents e9e7eb6 + 2f8ded9 commit c2e74d2

11 files changed

+86
-96
lines changed

articles/synapse-analytics/concepts-data-flow-overview.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -6,20 +6,18 @@ ms.author: makromer
66
ms.reviewer: daperlov
77
ms.service: azure-synapse-analytics
88
ms.subservice: pipeline
9-
ms.topic: conceptual
9+
ms.topic: concept-article
1010
ms.custom: references_regions
1111
ms.date: 12/16/2020
1212
---
1313

14-
# Data flows in Azure Synapse Analytics
15-
16-
## What are data flows?
14+
# What are data flows in Azure Synapse Analytics?
1715

1816
Data flows are visually designed data transformations in Azure Synapse Analytics. Data flows allow data engineers to develop data transformation logic without writing code. The resulting data flows are executed as activities within Azure Synapse Analytics pipelines that use scaled-out Apache Spark clusters. Data flow activities can be operationalized using existing Azure Synapse Analytics scheduling, control, flow, and monitoring capabilities.
1917

2018
Data flows provide an entirely visual experience with no coding required. Your data flows run on Synapse-managed execution clusters for scaled-out data processing. Azure Synapse Analytics handles all the code translation, path optimization, and execution of your data flow jobs.
2119

22-
## Getting started
20+
## Get started
2321

2422
Data flows are created from the Develop pane in Synapse studio. To create a data flow, select the plus sign next to **Develop**, and then select **Data Flow**.
2523

@@ -29,7 +27,7 @@ This action takes you to the data flow canvas, where you can create your transfo
2927

3028
## Authoring data flows
3129

32-
Data flow has a unique authoring canvas designed to make building transformation logic easy. The data flow canvas is separated into three parts: the top bar, the graph, and the configuration panel.
30+
Data flow has a unique authoring canvas designed to make building transformation logic easy. The data flow canvas is separated into three parts: the top bar, the graph, and the configuration panel.
3331

3432
![Screenshot shows the data flow canvas with top bar, graph, and configuration panel labeled.](media/data-flow/canvas-1.png)
3533

@@ -91,7 +89,7 @@ Data flow integrates with existing Azure Synapse Analytics monitoring capabiliti
9189

9290
The Azure Synapse Analytics team has created a [performance tuning guide](../data-factory/concepts-data-flow-performance.md?context=/azure/synapse-analytics/context/context) to help you optimize the execution time of your data flows after building your business logic.
9391

94-
## Next steps
92+
## Related content
9593

9694
* Learn how to create a [source transformation](../data-factory/data-flow-source.md?context=/azure/synapse-analytics/context/context).
9795
* Learn how to build your data flows in [debug mode](../data-factory/concepts-data-flow-debug-mode.md?context=/azure/synapse-analytics/context/context).

articles/synapse-analytics/data-integration/concepts-data-factory-differences.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn how the data integration capabilities of Azure Synapse Analyt
44
author: kromerm
55
ms.service: azure-synapse-analytics
66
ms.subservice: pipeline
7-
ms.topic: conceptual
7+
ms.topic: concept-article
88
ms.date: 02/15/2022
99
ms.author: makromer
1010
ms.reviewer: whhender
@@ -14,9 +14,6 @@ ms.reviewer: whhender
1414

1515
In Azure Synapse Analytics, the data integration capabilities such as Synapse pipelines and data flows are based upon those of Azure Data Factory. For more information, see [what is Azure Data Factory](../../data-factory/introduction.md).
1616

17-
18-
## Available features in ADF & Azure Synapse Analytics
19-
2017
Check below table for features availability:
2118

2219
| Category | Feature | Azure Data Factory | Azure Synapse Analytics |
@@ -29,6 +26,4 @@ Check below table for features availability:
2926
| **GIT Repository Integration** | GIT Integration |||
3027
| **Monitoring** | Monitoring of Spark Jobs for Data Flow ||*Leverage the Synapse Spark pools* |
3128

32-
## Next steps
33-
3429
Get started with data integration in your Synapse workspace by learning how to [ingest data into an Azure Data Lake Storage gen2 account](data-integration-data-lake.md).

articles/synapse-analytics/database-designer/concepts-database-templates.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
22
title: Azure Synapse database templates concepts
3-
description: Learn more about the database templates within Azure Synapse
3+
description: Learn about how you can standardize data in your late with the database templates within Azure Synapse.
44
author: gsaurer
55
ms.author: gesaur
66
ms.service: azure-synapse-analytics
77
ms.subservice: database-editor
8-
ms.topic: conceptual
8+
ms.topic: concept-article
99
ms.date: 11/02/2021
1010
ms.custom: template-concept
1111
---
@@ -16,7 +16,7 @@ Azure Synapse Analytics provides industry specific database templates to help st
1616

1717
## Enterprise templates
1818

19-
Enterprise database templates contain a subset of tables that are most likely to be of interest to an organization within a specific industry. It provides a high-level overview and describes the connectivity between the related business areas. These templates serve as an accelerator for many types of large projects. For example, the retail template has one enterprise template called "Retail".
19+
Enterprise database templates contain a subset of tables that are most likely to be of interest to an organization within a specific industry. It provides a high-level overview and describes the connectivity between the related business areas. These templates serve as an accelerator for many types of large projects. For example, the retail template has one enterprise template called "Retail".
2020

2121
![Enterprise template example](./media/concepts-database-templates/enterprise-template-example.png)
2222

@@ -48,7 +48,7 @@ Relationships are associations or interactions between any two tables. For examp
4848

4949
Lake database allows for the underlying data to be partitioned for a table for better performance. You can set partition configuration in the storage settings of a table in database editor.
5050

51-
## Next steps
51+
## Related content
5252

5353
Continue to explore the capabilities of the database designer using the links below.
5454
- [Quick start](quick-start-create-lake-database.md)

articles/synapse-analytics/database-designer/concepts-lake-database.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,31 +5,29 @@ author: matt1883
55
ms.author: mahi
66
ms.service: azure-synapse-analytics
77
ms.subservice: database-editor
8-
ms.topic: conceptual
8+
ms.topic: concept-article
99
ms.date: 11/02/2021
1010
ms.custom: template-concept
1111
---
1212

13-
1413
# Lake database
1514

16-
The lake database in Azure Synapse Analytics enables customers to bring together database design, meta information about the data that is stored and a possibility to describe how and where the data should be stored. Lake database addresses the challenge of today's data lakes where it is hard to understand how data is structured.
15+
The lake database in Azure Synapse Analytics enables customers to bring together database design, meta information about the data that is stored and a possibility to describe how and where the data should be stored. Lake database addresses the challenge of today's data lakes where it's hard to understand how data is structured.
1716

1817
![Lake database overview](./media/concepts-lake-database/lake-database-overview.png)
1918

20-
2119
## Database designer
2220

23-
The new database designer in Synapse Studio gives you the possibility to create a data model for your lake database and add additional information to it. Every Entity and Attribute can be described to provide more information about the model, which not only contains Entities but relationships as well. In particular, the inability to model relationships has been a challenge for the interaction on the data lake. This challenge is now addressed with an integrated designer that provides possibilities that have been available in databases but not on the lake. Also the capability to add descriptions and possible demo values to the model allows people who are interacting with it in the future to have information where they need it to get a better understanding about the data.
21+
The new database designer in Synapse Studio gives you the possibility to create a data model for your lake database and add additional information to it. Every Entity and Attribute can be described to provide more information about the model, which not only contains Entities but relationships as well. In particular, the inability to model relationships has been a challenge for the interaction on the data lake. This challenge is now addressed with an integrated designer that provides possibilities that have been available in databases but not on the lake. Also the capability to add descriptions and possible demo values to the model allows people who are interacting with it in the future to have information where they need it to get a better understanding about the data.
2422

25-
> [!NOTE]
23+
> [!NOTE]
2624
> The maximum size of metadata in a lake database is 10 GB. Attempting to publish or update a model that exceeds 10 GB in size will fail. To resolve this issue, reduce the model size by removing tables and columns. Consider splitting large models into multiple lake databases to avoid this limit.
2725
28-
## Data storage
26+
## Data storage
2927

30-
Lake databases use a data lake on the Azure Storage account to store the data of the database. The data can be stored in Parquet, Delta or CSV format and different settings can be used to optimize the storage. Every lake database uses a linked service to define the location of the root data folder. For every entity, separate folders are created by default within this database folder on the data lake. By default all tables within a lake database use the same format but the formats and location of the data can be changed per entity if that is requested.
28+
Lake databases use a data lake on the Azure Storage account to store the data of the database. The data can be stored in Parquet, Delta, or CSV format and different settings can be used to optimize the storage. Every lake database uses a linked service to define the location of the root data folder. For every entity, separate folders are created by default within this database folder on the data lake. By default all tables within a lake database use the same format but the formats and location of the data can be changed per entity if that is requested.
3129

32-
> [!NOTE]
30+
> [!NOTE]
3331
> Publishing a lake database does not create any of the underlying structures or schemas needed to query the data in Spark or SQL. After publishing, load data into your lake database using [pipelines](../data-integration/data-integration-data-lake.md) to begin querying it.
3432
>
3533
> Currently, Delta format support for lake databases is not supported in Synapse Studio.
@@ -38,9 +36,9 @@ Lake databases use a data lake on the Azure Storage account to store the data of
3836
3937
## Database compute
4038

41-
The lake database is exposed in Synapse SQL serverless SQL pool and Apache Spark providing users with the capability to decouple storage from compute. The metadata that is associated with the lake database makes it easy for different compute engines to not only provide an integrated experience but also use additional information (for example, relationships) that was not originally supported on the data lake.
39+
The lake database is exposed in Synapse SQL serverless SQL pool and Apache Spark providing users with the capability to decouple storage from compute. The metadata that is associated with the lake database makes it easy for different compute engines to not only provide an integrated experience but also use additional information (for example, relationships) that wasn't originally supported on the data lake.
4240

43-
## Next steps
41+
## Related content
4442

4543
Continue to explore the capabilities of the database designer using the links below.
4644
- [Create lake database quick start](quick-start-create-lake-database.md)

articles/synapse-analytics/database-designer/quick-start-create-lake-database.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,16 +6,17 @@ ms.author: gesaur
66
ms.reviewer: wiassaf, jovanpop
77
ms.service: azure-synapse-analytics
88
ms.subservice: database-editor
9-
ms.topic: conceptual
9+
ms.topic: quickstart
1010
ms.date: 08/16/2022
1111
ms.custom: template-concept
1212
---
1313

1414
# Quickstart: Create a new lake database leveraging database templates
1515

16-
This quick start gives you a complete sample scenario on how you can apply database templates to create a lake database, align data to your new model, and use the integrated experience to analyze the data.
16+
This quick start gives you a complete sample scenario on how you can apply database templates to create a lake database, align data to your new model, and use the integrated experience to analyze the data.
1717

1818
## Prerequisites
19+
1920
- At least **Synapse User** role permissions are required for exploring a lake database template from Gallery.
2021
- **Synapse Administrator**, or **Synapse Contributor** permissions are required on the Azure Synapse workspace for creating a lake database.
2122
- **Storage Blob Data Contributor** permissions are required on data lake when using create table **From data lake** option.
@@ -26,13 +27,13 @@ Use the new database templates functionality to create a lake database that you
2627

2728
For our scenario we will use the `Retail` database template and select the following entities:
2829

29-
- **RetailProduct** - A product is anything that can be offered to a market that might satisfy a need by potential customers. That product is the sum of all physical, psychological, symbolic, and service attributes associated with it.
30-
- **Transaction** - The lowest level of executable work or customer activity.
30+
- **RetailProduct** - A product is anything that can be offered to a market that might satisfy a need by potential customers. That product is the sum of all physical, psychological, symbolic, and service attributes associated with it.
31+
- **Transaction** - The lowest level of executable work or customer activity.
3132
A transaction consists of one or more discrete events.
32-
- **TransactionLineItem** - The components of a Transaction broken down by Product and Quantity, one per line item.
33-
- **Party** - A party is an individual, organization, legal entity, social organization, or business unit of interest to the business.
34-
- **Customer** - A customer is an individual or legal entity that has or has purchased a product or service.
35-
- **Channel** - A channel is a means by which products or services are sold and/or distributed.
33+
- **TransactionLineItem** - The components of a Transaction broken down by Product and Quantity, one per line item.
34+
- **Party** - A party is an individual, organization, legal entity, social organization, or business unit of interest to the business.
35+
- **Customer** - A customer is an individual or legal entity that has or has purchased a product or service.
36+
- **Channel** - A channel is a means by which products or services are sold and/or distributed.
3637

3738
The easiest way to find entities is by using the search box above the different business areas that contain the tables.
3839

@@ -83,6 +84,6 @@ You can use lake database to train your machine learning models and score the da
8384
## Next steps
8485

8586
Continue to explore the capabilities of the database designer using the links below.
86-
- [Database templates concept](concepts-database-templates.md)
87-
- [Lake database concept](concepts-lake-database.md)
88-
- [How to create a lake database](create-empty-lake-database.md)
87+
- [Database templates concept](concepts-database-templates.md)
88+
- [Lake database concept](concepts-lake-database.md)
89+
- [How to create a lake database](create-empty-lake-database.md)

articles/synapse-analytics/known-issues.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.reviewer: wiassaf, joanpo
88
ms.date: 04/08/2024
99
ms.service: azure-synapse-analytics
1010
ms.subservice: overview
11-
ms.topic: conceptual
11+
ms.topic: troubleshooting-known-issue
1212
---
1313

1414
# Azure Synapse Analytics known issues

0 commit comments

Comments
 (0)