Pipeline Migration
Migrates Synapse Data Factory pipelines to Fabric Data Factory, turning linked services...
Install
npx skills add microsoft/skills-for-fabric --skill pipeline-migration -g -a claude-code -y- Repository
- microsoft/skills-for-fabric1.3k
- Category
- Engineering
- Updated
- 6d ago
- License
- MIT
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Migrates Synapse Data Factory pipelines to Fabric Data Factory, turning linked services into Fabric connections, inlining datasets into activities, converting global parameters to Variable Libraries, and mapping SynapseNotebook to TridentNotebook. Use for pipeline JSON. For Synapse Spark notebook code use synapse-migration.
Telemetry, MANDATORY. Every
api.fabric.microsoft.comcall must carryx-ms-fabric-skill: pipeline-migration(az rest:--headers "x-ms-fabric-skill=pipeline-migration"), including every LRO poll,fabric_lroand retry. Snippets omit it, add it anyway.
CRITICAL NOTES
- To find workspace details (including its ID) from a workspace name: list all workspaces, then use JMESPath filtering
- To find item details (including its ID) from workspace ID, item type, and item name: list all items of that type in that workspace, then use JMESPath filtering
- Fabric does NOT have a "Dataset" item type, all dataset properties are inlined into activity
typeProperties- Linked Services map to Fabric Connections, in pipeline activity JSON,
referenceNameon the activity'slinkedServiceblock uses the Fabric connection display name (not the connection GUID); the connection GUID is used only on Fabric REST API calls- Notebook activities change from
SynapseNotebooktoTridentNotebookand reference notebooks by GUID, not by name- Synapse global parameters become a Variable Library item in Fabric, referenced as
@pipeline().libraryVariables.<name>. Variable LibraryNumbertypes are not consumable in pipelines, SynapseFloat/Doubleare mapped toStringfor runtime compatibility- The
Validationactivity type does not exist in Fabric, it must be rewritten asGetMetadata+IfCondition- Triggers are intentionally excluded from this skill, recreate schedules manually in Fabric after migration
- SSIS package execution, SHIR-exclusive connectors, and Databricks activities are parked, see pipeline-gotchas.md
