Skip to content

Commit 617774e

Browse files
authored
Add migration guide from Azure Synapse to Fabric
This document provides an overview of migrating from Azure Synapse to Microsoft Fabric, including steps for creating a Fabric workspace, linking Azure Data Lake Storage, and updating references.
1 parent 9ca83b2 commit 617774e

File tree

1 file changed

+72
-0
lines changed

1 file changed

+72
-0
lines changed
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
# Azure Synapse migrate to Microsoft Fabric - Overview
2+
3+
Costa Rica
4+
5+
[![GitHub](https://badgen.net/badge/icon/github?icon=github&label)](https://github.com)
6+
[![GitHub](https://img.shields.io/badge/--181717?logo=github&logoColor=ffffff)](https://github.com/)
7+
[brown9804](https://github.com/brown9804)
8+
9+
Last updated: 2025-04-08
10+
11+
----------
12+
13+
<details>
14+
<summary><b>List of References</b> (Click to expand)</summary>
15+
16+
- [Migrating from Azure Synapse Spark to Fabric](https://learn.microsoft.com/en-us/fabric/data-engineering/migrate-synapse-overview)
17+
- [Migration planning: Azure Synapse Analytics dedicated SQL pools to Fabric Data Warehouse](https://learn.microsoft.com/en-us/fabric/data-warehouse/migration-synapse-dedicated-sql-pool-warehouse#prepare-for-migration)
18+
19+
</details>
20+
21+
> Overall process: <br/>
22+
> - Create a Fabric workspace and link it to your existing Azure Data Lake Storage account. <br/>
23+
> - Import existing notebooks, Spark jobs into the Fabric workspace. <br/>
24+
> - Update references to external tables or files using the OneLake syntax.
25+
26+
## Overview
27+
28+
1. **Create a Fabric Workspace**
29+
- **Navigate to Microsoft Fabric**: Access the [Microsoft Fabric portal](https://app.fabric.microsoft.com/).
30+
31+
<img width="550" alt="image" src="https://github.com/user-attachments/assets/191672f9-e7b0-460b-aa23-886fa105f97e" style="border: 2px solid #4CAF50; border-radius: 5px; padding: 5px;"/>
32+
33+
- **Create Workspace**: Follow the steps to create a new workspace.
34+
35+
https://github.com/user-attachments/assets/209f18fd-d14a-4e2f-aff2-d6cb7be13cc1
36+
37+
2. **Link ADLS Account**: Connect your existing Azure Data Lake Storage account to the new Fabric workspace.
38+
- **Set Up ADLS Connection**:
39+
- **Open Fabric Workspace**: Go to the workspace where you want to set up the connection.
40+
41+
<img width="550" alt="image" src="https://github.com/user-attachments/assets/f4c87199-0d61-4db6-accd-27608d2257be" />
42+
43+
- **Create a lakehouse**: Click on `New item`, search for `Lakehouse`:
44+
45+
<img width="550" alt="image" src="https://github.com/user-attachments/assets/602b5d88-b1bc-44ff-9a0e-a3c6ddc15527">
46+
47+
<img width="550" alt="image" src="https://github.com/user-attachments/assets/9b807c02-2111-4277-8e97-be0b08212ee6" />
48+
49+
- **Get Data**: Select the option to get data from Azure Data Lake Storage Gen2.
50+
- **Enter ADLS URL**: Provide the URL to your Azure Data Lake Storage Gen2 account.
51+
- **Authentication**: Choose the authentication method (e.g., account key, organizational account, service principal, or shared access signature).
52+
- **Sign In**: Sign in to your Azure Data Lake Storage account using the selected authentication method.
53+
- **Configure Connection**: Complete the configuration by specifying any additional settings required for the connection.
54+
- **Create OneLake Shortcut**:
55+
- **Navigate to Lakehouse View**: In the Fabric workspace, go to the Lakehouse view.
56+
- **Create Shortcut**: Right-click and select "New Shortcut," then choose Azure Data Lake Storage Gen2 as the source.
57+
- **Enter Details**: Provide the URL of the ADLS Gen2 account, connection name, authentication method, shortcut name, and subpath pointing to the root of the data you want to reference.
58+
- **Create Shortcut**: Click "Create" and wait for the shortcut to appear in the Lakehouse view.
59+
- **Preview Data**: Preview the data from the shortcut to ensure it is virtualized from the source.
60+
2. **Import Existing Notebooks and Spark Jobs**
61+
- **Export from Synapse**: Export your notebooks and Spark job definitions from Azure Synapse.
62+
- **Import to Fabric**: Use the import functionality in Fabric to bring these items into your new workspace.
63+
3. **Update References**
64+
- **Identify External References**: Locate all references to external tables or files in your notebooks and Spark jobs.
65+
- **Modify Syntax**: Update these references to use the OneLake syntax, ensuring they point to the correct locations in Fabric.
66+
67+
<!-- START BADGE -->
68+
<div align="center">
69+
<img src="https://img.shields.io/badge/Total%20views-1418-limegreen" alt="Total views">
70+
<p>Refresh Date: 2025-10-09</p>
71+
</div>
72+
<!-- END BADGE -->

0 commit comments

Comments
 (0)