tutorial-transform-data.md

title	Data Warehouse Tutorial: Transform Data with a Stored Procedure in a Warehouse
description	In this tutorial, learn how to create a stored procedure in a Warehouse to transform data in a table.
ms.reviewer	scbradl
ms.date	04/06/2025
ms.topic	tutorial

Tutorial: Transform data with a stored procedure in a Warehouse

Applies to: [!INCLUDE fabric-se-and-dw]

In this tutorial, learn how to create a stored procedure in a Warehouse to transform data in a table.

Note

This tutorial forms part of an end-to-end scenario. In order to complete this tutorial, you must first complete these tutorials:

1. Create a workspace
2. Create a Warehouse
3. Ingest data into a Warehouse

Create a stored procedure

In this task, learn how to create a stored procedure to transform data in a warehouse table.

1. Ensure that the workspace you created in the first tutorial is open.

2. On the Home ribbon, select New SQL query.

   :::image type="content" source="media/tutorial-transform-data/ribbon-new-sql-query.png" alt-text="Screenshot of the Home ribbon, highlighting the New SQL query option." lightbox="media/tutorial-transform-data/ribbon-new-sql-query.png":::

3. In the query editor, paste the following code. The code drops the stored procedure (if it exists), and it then creates a stored procedure named populate_aggregate_sale_by_city. The stored procedure logic creates a table named aggregate_sale_by_date_city and inserts data into it with a group-by query that joins the fact_sale and dimension_city tables.

    --Drop the stored procedure if it already exists.
    DROP PROCEDURE IF EXISTS [dbo].[populate_aggregate_sale_by_city];
    GO
   
    --Create the populate_aggregate_sale_by_city stored procedure.
    CREATE PROCEDURE [dbo].[populate_aggregate_sale_by_city]
    AS
    BEGIN
        --Drop the aggregate table if it already exists.
        DROP TABLE IF EXISTS [dbo].[aggregate_sale_by_date_city];
        --Create the aggregate table.
        CREATE TABLE [dbo].[aggregate_sale_by_date_city]
        (
           [Date] [DATETIME2](6),
           [City] [VARCHAR](8000),
           [StateProvince] [VARCHAR](8000),
           [SalesTerritory] [VARCHAR](8000),
           [SumOfTotalExcludingTax] [DECIMAL](38,2),
           [SumOfTaxAmount] [DECIMAL](38,6),
           [SumOfTotalIncludingTax] [DECIMAL](38,6),
           [SumOfProfit] [DECIMAL](38,2)
        );
        
        --Load aggregated data into the table.
        INSERT INTO [dbo].[aggregate_sale_by_date_city]
        SELECT
           FS.[InvoiceDateKey] AS [Date], 
           DC.[City], 
           DC.[StateProvince], 
           DC.[SalesTerritory], 
           SUM(FS.[TotalExcludingTax]) AS [SumOfTotalExcludingTax], 
           SUM(FS.[TaxAmount]) AS [SumOfTaxAmount], 
           SUM(FS.[TotalIncludingTax]) AS [SumOfTotalIncludingTax], 
           SUM(FS.[Profit]) AS [SumOfProfit]
        FROM [dbo].[fact_sale] AS FS
        INNER JOIN [dbo].[dimension_city] AS DC
           ON FS.[CityKey] = DC.[CityKey]
        GROUP BY
           FS.[InvoiceDateKey],
           DC.[City], 
           DC.[StateProvince], 
           DC.[SalesTerritory]
        ORDER BY 
           FS.[InvoiceDateKey], 
           DC.[StateProvince], 
           DC.[City];
    END;

4. To execute the query, on the query designer ribbon, select Run.

5. When execution completes, rename the query as Create Aggregate Procedure.

6. In the Explorer pane, from inside the Stored Procedures folder for the dbo schema, verify that the aggregate_sale_by_date_city stored procedure exists.

   :::image type="content" source="media/tutorial-transform-data/explorer-stored-procedure.png" alt-text="Screenshot of the Explorer pane, highlighting the newly created stored procedure.":::

Run the stored procedure

In this task, learn how to execute the stored procedure to transform data in a warehouse table.

1. Create a new query.

2. In the query editor, paste the following code. The code executes the populate_aggregate_sale_by_city stored procedure.

    --Execute the stored procedure to create and load aggregated data.
    EXEC [dbo].[populate_aggregate_sale_by_city];

3. Run the query.

4. When execution completes, rename the query as Run Aggregate Procedure.

5. To preview the aggregated data, in the Explorer pane, select the aggregate_sale_by_date_city table.

   [!NOTE] If the table doesn't appear, select the ellipsis (...) for the Tables folder, and then select Refresh.

   :::image type="content" source="media/tutorial-transform-data/explorer-aggregate-table.png" alt-text="Screenshot of the Explorer pane, highlighting the newly created table.":::

Next step

[!div class="nextstepaction"] Tutorial: Time travel with T-SQL in a Warehouse