用途：把 Synapse Analytics 工作区资产迁移到 Microsoft Fabric，包括 Spark 项、Lake Database、Linked Service，以及将 Dedicated SQL Pool 的架构与可执行代码（存储过程）转换到 Lakehouse 或 Warehouse。全部调用 api.fabric.microsoft.com 时须携带 x-ms-fabric-skill: synapse-migration 头（az rest 用 --headers），长轮询与重试同样需要。
主要能力：按阶段执行发现、目标路由、差距评估、审批、转换、部署与验证；维护 migration-manifest.json，记录审批、逐对象状态、哈希与检查点；把存储过程映射为可追溯的 Spark SQL 笔记本（含 %%sql 单元格），视图仍作为架构对象；支持 Spark Pool 转 Fabric Environment、Lake Database/HMS 绑定、Notebook/SDF 移植、Linked Service 转 Fabric Data Connection 或 OneLake Shortcut。
使用方式：先决定目标。纯离线且输入契约完整时走 fast path，只加载该路径。否则按需求按需加载参考文件，如 migration-orchestrator.md、dedicated-pool-to-lakehouse.md、spark-pool-migration.md 等；Dedicated Pool 逐阶段执行发现、差距评估、映射审批、转换、部署、验证。全工作区迁移读取 migration-orchestrator.md。
限制：源 Dedicated SQL Pool 只读，不得运行源 DDL/DML/存储过程。Dedicated Pool 到 Lakehouse 不搬运数据行，Warehouse 数据迁移需单独同意门与还原源契约。不在 artifact 迁移中执行生成的 notebook 或 pipeline。不保留 Synapse 分布/存储提示、PolyBase DDL、连接字符串等。不硬编码工作区或项 ID、凭据与路径。针对 Warehouse 目标的完整 DISTRIBUTION 与 CLUSTERED COLUMNSTORE INDEX 声明会被移除。Synapse Link 不在覆盖范围，改用 Fabric Mirroring。具体收费、价格与配额信息暂未提供。