synapse-migration

Migrate Azure Synapse Spark workloads to Microsoft Fabric with artifact rewrites.

952|267|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/microsoft/skills-for-fabric --skill synapse-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synapse-migration
Source: https://github.com/microsoft/skills-for-fabric/tree/main/plugins/fabric-skills/skills/synapse-migration
Command: npx skills add https://github.com/microsoft/skills-for-fabric --skill synapse-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Port Azure Synapse Spark workloads to Microsoft Fabric by automating inventory, mapping decisions, and artifact rewrites across Notebooks, SJDs, and Lake Databases.

Core Features & Use Cases

  • Automates end-to-end migration of Synapse Spark workloads to Fabric, including Notebooks, Spark Job Definitions, and Lake Databases.
  • Rewrites Synapse-specific patterns (mssparkutils, linked services) to Fabric equivalents (notebookutils, Data Connections, OneLake Shortcuts).
  • Provides phased validation gates, mapping options (schemas-in-one Lakehouse vs separate Lakehouses), and auto-bindings for Notebooks/SJDs.

Quick Start

Run the synapse-migration workflow to migrate notebooks, Spark Job Definitions, and Lake Databases from Synapse to Fabric.

Frequently Asked Questions about synapse-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Azure Synapse Spark workloads to Microsoft Fabric?

To migrate Azure Synapse Spark workloads to Microsoft Fabric, you can automate inventory, mapping decisions, and artifact rewrites across Notebooks, Spark Job Definitions, and Lake Databases using a guided workflow with phased validation gates.

What is the best way to convert Synapse mssparkutils and Linked Services for Fabric?

The best way to convert Synapse mssparkutils and Linked Services is to use automated tooling that rewrites these specific patterns into Fabric equivalents like notebookutils, Data Connections, and OneLake Shortcuts during your migration.

How does migrating Synapse Lake Databases to Fabric OneLake work?

Migrating Synapse Lake Databases to Fabric OneLake involves orchestrating inventory and mapping decisions, offering options for schemas in a single Lakehouse or separate Lakehouses, and applying auto-bindings for Notebooks and Spark Job Definitions.

Can I migrate Synapse Spark Job Definitions to Fabric automatically?

Yes, you can automatically migrate Synapse Spark Job Definitions to Fabric. The migration process includes phased validation gates and auto-bindings to ensure your SJDs are correctly mapped and rewritten for the Fabric environment.

What happens if my Synapse Spark workload uses an external Hive metastore?

If your Synapse Spark workload uses an external Hive metastore, the migration process flags the external HMS as a blocker. Phased validation gates surface these blockers to guide your mapping decisions before artifact rewrites proceed.

Does migrating Synapse Notebooks to Fabric require manual code rewrites?

Migrating Synapse Notebooks to Fabric does not require extensive manual code rewrites. Automated tooling rewrites Synapse-specific patterns and ADLS access patterns into Fabric equivalents, while enforcing best practices through validity checks.