pipeline-migration

Migrate Synapse Data Factory pipelines to Microsoft Fabric Data Factory via REST APIs.

Updated Jul 14, 2026
One-click install
npx skills add https://github.com/9vantage/skills-for-fabric-clone --skill pipeline-migration-9vantage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pipeline-migration
Source: https://github.com/9vantage/skills-for-fabric-clone/tree/main/plugins/fabric-skills/skills/pipeline-migration
Command: npx skills add https://github.com/9vantage/skills-for-fabric-clone --skill pipeline-migration-9vantage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes references (resource) components.

What problem does it solve? Moving Azure Synapse Analytics pipelines to Microsoft Fabric Data Factory requires manual translation of activity types, linked services, datasets, and global parameters, which is error-prone and slow when done by hand. ## Core Features & Use Cases - Activity Type Translation: Converts SynapseNotebook activities to TridentNotebook with GUID references, rewrites Validation activities as GetMetadata plus IfCondition, and parks unsupported SSIS, Databricks, and SHIR-only activities. - Resource Mapping: Translates linked services into Fabric Connections, inlines dataset definitions directly into activity typeProperties, and converts global parameters into a Fabric Variable Library with value sets. - Assessment and Orchestration: Runs a read-only pre-migration assessment of a Synapse workspace, then executes phased migration through Synapse data-plane and Fabric REST APIs with validation and migration reporting. - Use Case: A data engineer needs to move 40 Synapse pipelines to Fabric. The skill assesses the workspace, migrates notebooks first, creates connections and a Variable Library, then deploys rewritten pipeline JSON to the Fabric workspace. ## Quick Start Ask the assistant to migrate the pipelines from your Synapse workspace into a named Microsoft Fabric workspace, optionally running the assessment first.

Frequently Asked Questions about pipeline-migration

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

FAQPage Schema
How do I migrate Synapse pipelines to Microsoft Fabric?

Run the pre-migration assessment against your Synapse workspace, then execute the phased migration: notebooks first, then global parameters to a Variable Library, linked services to Fabric Connections, dataset inlining, and finally pipeline deployment via the Fabric REST API.

How to convert SynapseNotebook activities to Fabric TridentNotebook?

Rename the activity type to TridentNotebook, replace the notebook name reference with the Fabric notebook GUID from the workspace notebook list, add the workspaceId, and remove sparkPool and sessionConfiguration blocks since pool config moves to the Fabric Environment.

Which Synapse pipeline activities cannot be migrated to Fabric?

ExecuteSSISPackage, DatabricksNotebook, DatabricksSparkJar, DatabricksSparkPython, AzureBatch, Custom, and HDInsight Hive/Pig/MapReduce activities are parked because they have no Fabric equivalent. Activities using SHIR-only connectors require an on-premises data gateway.

Does Microsoft Fabric support Synapse global parameters?

Fabric replaces global parameters with Variable Library items referenced via @pipeline().libraryVariables.<name>. Array and Object types are serialized as JSON strings, and Float/Double map to String because Number types are not consumable in pipelines.

Why does my migrated Fabric pipeline fail on dataset references?

Fabric has no Dataset item type, so any activity still referencing a named dataset is invalid. All dataset properties must be inlined into the activity's source, sink, or dataset block, with the linked service replaced by the Fabric connection display name.

Are Synapse pipeline triggers migrated to Fabric automatically?

No, triggers are intentionally excluded from the migration. After validating the migrated pipelines in Fabric, you must recreate schedules manually using Fabric's job scheduling capabilities.