用途:将 Synapse Data Factory 管道迁移到 Fabric Data Factory,覆盖活动类型转换、链接服务→连接、数据集内联、全局参数→变量库等步骤。
主要能力:SynapseNotebook 转 TridentNotebook 并按 GUID 引用;Copy/Lookup/GetMetadata/Delete 等兼容活动迁移并内联数据集;Validation 改写为 GetMetadata + IfCondition;全局参数改写为 @pipeline().libraryVariables.<name>;ExecutePipeline 补充 workspaceId。提供预迁移评估、编排器、活动映射、验证测试、迁移报告等参考文件。
使用方式:以 az rest 调用 API,每次 api.fabric.microsoft.com 调用(含 LRO 轮询、fabric_lro、重试)必须携带 x-ms-fabric-skill: pipeline-migration 头,例如 --headers "x-ms-fabric-skill=pipeline-migration"。Synapse 数据面令牌受众为 https://dev.azuresynapse.net,ARM 为 https://management.azure.com,Fabric REST 为 https://api.fabric.microsoft.com,令牌用 az account get-access-token --resource <audience> --query accessToken -o tsv 获取。迁移按阶段执行:Phase 0 先迁移被引用的笔记本,Phase 1 全局参数→变量库,Phase 2 链接服务→连接,Phase 3 数据集内联,Phase 4 活动迁移,Phase 5 组装并部署管道 JSON,最后验证。
限制:Fabric 无 Dataset 项类型,必须内联;Fabric 无 Validation 活动;触发器不在此技能范围内,需迁移后手动重建计划;SSIS、SHIR 专属连接器、Databricks、AzureBatch、Custom 活动被搁置,需人工处理;Variable Library 的 Number 类型在管道中不可用,Synapse Float/Double 会映射为 String;中文文档中部分细节以原资源文件为准。