Merge pull request #297665 from ShawnJackson/azure-data-factory-quickstarts

[AQ] edit pass: Azure Data Factory quickstarts

Author: LHL407

articles/data-factory/data-flow-create.md

@@ -1,6 +1,6 @@
 ---
-title: Create a mapping data flow
-description: How to create an Azure Data Factory mapping data flow
+title: Create a Mapping Data Flow
+description: Learn how to create a mapping data flow in Azure Data Factory and Azure Synapse Analytics.
 author: whhender
 ms.author: whhender
 ms.reviewer: makromer
@@ -9,57 +9,63 @@ ms.topic: quickstart
 ms.date: 02/13/2025
 ---
 
-# Create Azure Data Factory data flows
+# Quickstart: Create a mapping data flow in Azure Data Factory and Azure Synapse Analytics
 
 [!INCLUDE[appliesto-adf-asa-md](includes/appliesto-adf-asa-md.md)]
 
 [!INCLUDE[data-flow-preamble](includes/data-flow-preamble.md)]
 
-Mapping Data Flows provide a way to transform data at scale without any coding required. You can design a data transformation job in the data flow designer by constructing a series of transformations. Start with any number of source transformations followed by data transformation steps. Then, complete your data flow with sink to land your results in a destination.
+A mapping data flow provides a way to transform data at scale without any coding required. You can design a data transformation job in the data flow designer by constructing a series of transformations. Start with any number of source transformations, followed by data transformation steps. Then, complete your data flow with a sink to land your results in a destination.
 
 ## Steps to create a new data flow
 
 # [Azure Data Factory](#tab/data-factory)
 
-Get started by first [creating a new V2 Data Factory](quickstart-create-data-factory-portal.md) from the Azure portal. After creating your new factory, select the **Open Azure Data Factory Studio** tile in the portal to launch the Data Factory Studio.
+1. [Create a new V2 data factory by using the Azure portal](quickstart-create-data-factory-portal.md).
 
-:::image type="content" source="media/data-flow-create/open-data-factory-studio-from-portal.png" alt-text="Shows a screenshot of how to open the Data Factory Studio from the Azure portal.":::
+1. In the portal, go to your data factory. Select **Overview**, and then select the **Open Azure Data Factory Studio** tile.
 
-You can add sample Data Flows from the template gallery. To browse the gallery, select the **Author** tab in Data Factory Studio and click the plus sign to choose **Pipeline** | **Template Gallery**.
+   :::image type="content" source="media/data-flow-create/open-data-factory-studio-from-portal.png" alt-text="Screenshot that shows the tile for opening Azure Data Factory Studio in the Azure portal.":::
 
-:::image type="content" source="media/data-flow-create/open-template-gallery-from-data-factory.png" alt-text="Shows how to open the template gallery in Data Factory.":::
+1. In Azure Data Factory Studio, you can add sample data flows from the template gallery. To browse the gallery, go to the **Author** tab. Select the plus sign, and then choose **Pipeline** > **Template gallery**.
 
-Select the Data Flow category there to choose from the available templates.
+   :::image type="content" source="media/data-flow-create/open-template-gallery-from-data-factory.png" alt-text="Screenshot that shows selections for opening the template gallery in Azure Data Factory Studio.":::
 
-:::image type="content" source="media/data-flow-create/template-gallery-filtered-for-data-flow.png" alt-text="Shows the template gallery filtered for data flows.":::
+1. Filter by the **Data flow** category to choose from the available templates.
 
-You can also add data flows directly to your data factory without using a template. Select the **Author** tab in Data Factory Studio and click the plus sign to choose **Data Flow** | **Data Flow**.  
+   :::image type="content" source="media/data-flow-create/template-gallery-filtered-for-data-flow.png" alt-text="Screenshot that shows the template gallery filtered for data flows.":::
 
-:::image type="content" source="media/data-flow-create/create-data-flow-directly.png" alt-text="Shows a screenshot of how to create an empty data flow directly.":::
+You can also add data flows directly to your data factory without using a template. On the **Author** tab in Azure Data Factory Studio, select the plus sign, and then choose **Data flow** > **Data flow**.  
 
-# [Azure Synapse](#tab/synapse-analytics)
+:::image type="content" source="media/data-flow-create/create-data-flow-directly.png" alt-text="Screenshot that shows selections for creating an empty data flow directly.":::
 
-Get started by first [creating a new Synapse Workspace](../synapse-analytics/quickstart-create-workspace.md) from the Azure portal. After creating your new workspace, select the **Open Azure  Studio** tile to launch the Data Factory UI.
-    
-:::image type="content" source="media/data-flow-create/open-synapse-studio-from-portal.png" alt-text="Shows a screenshot of how to open the Synapse Studio from the Azure portal.":::
+# [Azure Synapse Analytics](#tab/synapse-analytics)
 
-You can add sample Data Flows from the template gallery.  To browse the gallery, select the **Integrate** tab in Synapse Studio and click the plus sign to choose **Browse Gallery**.
+1. [Create a new Azure Synapse Analytics workspace by using the Azure portal](../synapse-analytics/quickstart-create-workspace.md).
 
-:::image type="content" source="media/data-flow-create/open-template-gallery-from-synapse.png" alt-text="Shows how to open the template gallery in Data Factory.":::
+1. In the portal, go to your workspace. Select **Overview**, and then select the **Open Synapse Studio** tile.
 
-Filter on Category:Data Flow there to choose from the available templates.
+   :::image type="content" source="media/data-flow-create/open-synapse-studio-from-portal.png" alt-text="Screenshot that shows the tile for opening Azure Synapse Analytics Studio in the Azure portal.":::
 
-:::image type="content" source="media/data-flow-create/synapse-template-gallery-filtered-for-data-flow.png" alt-text="Shows the template gallery filtered for data flows.":::
+1. In Azure Synapse Analytics Studio, you can add sample data flows from the template gallery. To browse the gallery, go to the **Integrate** tab. Select the plus sign, and then choose **Browse gallery**.
 
-You can also add data flows directly to your workspace without using a template. Select the **Integrate** tab in Synapse Studio and click the plus sign to choose **Pipeline**.  Then in your pipeline, expand the **Move & transform** Activities section and drag a **Data flow** onto the canvas for the pipeline.
+   :::image type="content" source="media/data-flow-create/open-template-gallery-from-synapse.png" alt-text="Screenshot that shows selections for opening the template gallery in Azure Synapse Analytics Studio.":::
 
-:::image type="content" source="media/data-flow-create/create-pipeline-in-synapse.png" alt-text="Shows a screenshot of how to create an empty pipeline directly.":::
+1. Filter by the **Data flow** category to choose from the available templates.
 
-:::image type="content" source="media/data-flow-create/add-data-flow-to-pipeline-synapse.png" alt-text="Shows a screenshot of how to add an empty data flow to a pipeline directly.":::
+   :::image type="content" source="media/data-flow-create/synapse-template-gallery-filtered-for-data-flow.png" alt-text="Screenshot that shows the template gallery filtered for data flows.":::
+
+You can also add data flows directly to your workspace without using a template. On the **Integrate** tab in Azure Synapse Analytics Studio, select the plus sign, and then choose **Pipeline**.
+
+:::image type="content" source="media/data-flow-create/create-pipeline-in-synapse.png" alt-text="Screenshot that shows selections for creating an empty pipeline directly.":::
+
+Then, in your pipeline, expand the **Move & transform** > **Activities** section and drag **Data flow** onto the canvas for the pipeline.
+
+:::image type="content" source="media/data-flow-create/add-data-flow-to-pipeline-synapse.png" alt-text="Screenshot that shows selections for adding an empty data flow to a pipeline directly.":::
 
 ---
 
 ## Related content
 
 * [Tutorial: Transform data using mapping data flows](tutorial-data-flow.md)
-* Begin building your data transformation with a [source transformation](data-flow-source.md).
+* [Source transformation in mapping data flows](data-flow-source.md)

articles/data-factory/includes/data-flow-preamble.md

@@ -6,4 +6,4 @@ ms.date: 10/20/2023
 ms.author: susabat
 ms.reviewer: whhender
 ---
-Data flows are available both in Azure Data Factory and Azure Synapse Pipelines. This article applies to mapping data flows. If you are new to transformations, please refer to the introductory article [Transform data using a mapping data flow](../tutorial-data-flow.md).
+Data flows are available in both Azure Data Factory pipelines and Azure Synapse Analytics pipelines. This article applies to mapping data flows. If you're new to transformations, refer to the introductory article [Transform data using mapping data flows](../tutorial-data-flow.md).

articles/data-factory/quickstart-create-data-factory.md

@@ -1,6 +1,6 @@
 ---
 title: Create an Azure Data Factory
-description: Learn how to create a data factory using UI from the Azure portal.
+description: Learn how to create a data factory by using Azure Data Factory Studio or the Azure portal.
 author: whhender
 ms.topic: quickstart
 ms.subservice: authoring
@@ -9,76 +9,77 @@ ms.author: whhender
 ms.reviewer: xupzhou
 ---
 
-# Quickstart: Create a data factory by using the Azure portal
+# Quickstart: Create a data factory
 
 [!INCLUDE[appliesto-adf-xxx-md](includes/appliesto-adf-xxx-md.md)]
 
-This quickstart describes how to use either the [Azure Data Factory Studio](https://adf.azure.com) or the [Azure portal UI](https://portal.azure.com) to create a data factory.
+This quickstart describes how to use either [Azure Data Factory Studio](https://adf.azure.com) or the [Azure portal UI](https://portal.azure.com) to create a data factory.
 
-> [!NOTE]
-> If you are new to Azure Data Factory, see [Introduction to Azure Data Factory](introduction.md) before trying this quickstart. 
+If you're new to Azure Data Factory, see the [introduction to the service](introduction.md) before you try this quickstart.
 
 ## Prerequisites
 
-### Azure subscription
+- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
+- Make sure that you have the required Azure roles to create a data factory. For more information, see [Roles and permissions for Azure Data Factory](concepts-roles-permissions.md).
 
-If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/) before you begin.
+## Create a data factory in Azure Data Factory Studio
 
-### Azure roles
+By using Azure Data Factory Studio, you can create a data factory in seconds:
 
-To learn about the Azure role requirements to create a data factory, refer to [Azure Roles requirements](quickstart-create-data-factory-dot-net.md?#azure-roles).
+1. Open the Microsoft Edge or Google Chrome web browser. Currently, the Data Factory UI is supported only in these browsers.
 
-## Create a data factory
+1. Go to [Azure Data Factory Studio](https://adf.azure.com) and select the **Create a new data factory** option.
 
-A quick creation experience provided in the Azure Data Factory Studio to enable users to create a data factory within seconds. More advanced creation options are available in Azure portal.
+1. You can use the default values for the new data factory. Or you can choose a unique name, a preferred location, and a specific subscription. When you finish with these details, select **Create**.
 
-### Quick creation in the Azure Data Factory Studio
+   :::image type="content" source="media/quickstart-create-data-factory/create-with-azure-data-factory-studio.png" alt-text="Screenshot that shows the Azure Data Factory Studio page for creating a data factory.":::
 
-1. Launch **Microsoft Edge** or **Google Chrome** web browser. Currently, Data Factory UI is supported only in Microsoft Edge and Google Chrome web browsers.
-1. Go to the [Azure Data Factory Studio](https://adf.azure.com) and choose the **Create a new data factory** radio button.
-1. You can use the default values to create directly, or enter a unique name and choose a preferred location and subscription to use when creating the new data factory.
-   
-   :::image type="content" source="media/quickstart-create-data-factory/create-with-azure-data-factory-studio.png" alt-text="Shows a screenshot of the Azure Data Factory Studio page to create a new data factory.":::
+After you create a data factory, you can go to it from the home page of Azure Data Factory Studio.
 
-1. After creation, you can directly enter the homepage of the [Azure Data Factory Studio](https://adf.azure.com).
+   :::image type="content" source="media/quickstart-create-data-factory/azure-data-factory-studio-home-page.png" alt-text="Screenshot that shows the Azure Data Factory Studio page for a created data factory.":::
 
-   :::image type="content" source="media/quickstart-create-data-factory/azure-data-factory-studio-home-page.png" alt-text="Shows a screenshot of the Azure Data Factory Studio home page.":::
+## Create a data factory in the Azure portal
 
-### Advanced creation in the Azure portal
+When you use the Azure portal to create a data factory, the creation options are more advanced:
 
-1. Launch **Microsoft Edge** or **Google Chrome** web browser. Currently, Data Factory UI is supported only in Microsoft Edge and Google Chrome web browsers.
-1. Go to the [Azure portal data factories page](https://portal.azure.com/#browse/Microsoft.DataFactory%2FdataFactories). 
-1. After landing on the data factories page of the Azure portal, click **Create**.
+1. Open the Microsoft Edge or Google Chrome web browser. Currently, the Data Factory UI is supported only in these browsers.
 
-   :::image type="content" source="media/quickstart-create-data-factory/data-factory-create-from-portal.png" alt-text="Shows a screenshot of the Azure portal data factories Create button.":::
+1. Go to the [page for data factories in the Azure portal](https://portal.azure.com/#browse/Microsoft.DataFactory%2FdataFactories).
 
-1. For **Resource Group**, take one of the following steps:
-   1. Select an existing resource group from the drop-down list.
-   1. Select **Create new**, and enter the name of a new resource group.
-   
-      To learn about resource groups, see [Use resource groups to manage your Azure resources](../azure-resource-manager/management/overview.md). 
+1. Select **Create**.
+
+   :::image type="content" source="media/quickstart-create-data-factory/data-factory-create-from-portal.png" alt-text="Screenshot of the Create button on the Azure portal page for data factories.":::
+
+1. For **Resource group**, take one of the following steps:
+   - Select an existing resource group from the dropdown list.
+   - Select **Create new**, and then enter the name of a new resource group.
+
+   To learn about resource groups, see [What is a resource group?](../azure-resource-manager/management/overview.md#resource-groups).
 
 1. For **Region**, select the location for the data factory.
 
-   The list shows only locations that Data Factory supports, and where your Azure Data Factory meta data will be stored. The associated data stores (like Azure Storage and Azure SQL Database) and computes (like Azure HDInsight) that Data Factory uses can run in other regions.
- 
+   The list shows only locations that Data Factory supports, and where your Data Factory metadata will be stored. The associated data stores (like Azure Storage and Azure SQL Database) and computes (like Azure HDInsight) that Data Factory uses can run in other regions.
+
 1. For **Name**, enter **ADFTutorialDataFactory**.
-   
-   The name of the Azure data factory must be *globally unique*. If you see the following error, change the name of the data factory (for example, **<yourname>ADFTutorialDataFactory**) and try creating again. For naming rules for Data Factory artifacts, see the [Data Factory - naming rules](naming-rules.md) article.
 
-   :::image type="content" source="./media/doc-common-process/name-not-available-error.png" alt-text="New data factory error message for duplicate name.":::
+   The name of the data factory must be *globally unique*. If you see the following error, change the name of the data factory (for example, to **\<yourname\>ADFTutorialDataFactory**) and try creating it again. To learn about naming rules for Data Factory artifacts, see [Data Factory naming rules](naming-rules.md).
+
+   :::image type="content" source="./media/doc-common-process/name-not-available-error.png" alt-text="Screenshot that shows an error for a new data factory that indicates a duplicate name.":::
 
 1. For **Version**, select **V2**.
 
-1. Select **Review + create**, and select **Create** after the validation is passed. After the creation is complete, select **Go to resource** to navigate to the **Data Factory** page. 
+1. Select **Review + create**. After your configuration passes validation, select **Create**.
+
+1. After the creation is complete, select **Go to resource**.
+
+1. On the page for your data factory, select **Launch Studio** to open Azure Data Factory Studio. Then, start the Azure Data Factory UI application on a separate browser tab.
+
+   :::image type="content" source="./media/quickstart-create-data-factory/azure-data-factory-launch-studio.png" alt-text="Screenshot of the home page for a data factory in the Azure portal, with the button for opening Azure Data Factory Studio highlighted.":::
 
-1. Select **Launch Studio** to open Azure Data Factory Studio to start the Azure Data Factory user interface (UI) application on a separate browser tab.
-   
-   :::image type="content" source="./media/quickstart-create-data-factory/azure-data-factory-launch-studio.png" alt-text="Home page for the Azure Data Factory, with the Open Azure Data Factory Studio tile highlighted.":::
-   
    > [!NOTE]
-   > If you see that the web browser is stuck at "Authorizing", clear the **Block third-party cookies and site data** check box. Or keep it selected, create an exception for **login.microsoftonline.com**, and then try to open the app again.
+   > If the web browser is stuck at **Authorizing**, clear the **Block third-party cookies and site data** checkbox. Or keep it selected, create an exception for **login.microsoftonline.com**, and then try to open the app again.
 
 ## Related content
-Learn how to use Azure Data Factory to copy data from one location to another with the [Hello World - How to copy data](quickstart-hello-world-copy-data-tool.md) tutorial.
-Lean how to create a data flow with Azure Data Factory[data-flow-create.md].
+
+- Learn how to [use Azure Data Factory to copy data from one location to another](quickstart-hello-world-copy-data-tool.md).
+- Learn how to [create a data flow by using Azure Data Factory](data-flow-create.md).