用途:把现有 Databricks 笔记本与作业迁移到 Microsoft Fabric,覆盖 dbutils→notebookutils、机密范围→Key Vault、DBFS→OneLake、Unity Catalog 命名空间映射、集群配置→Spark 池、Databricks Jobs→Spark Job Definitions、Delta Sharing、MLflow 等主题。
主要能力:提供迁移编排、工作负载映射表、dbutils 到 notebookutils 的逐项 API 对照、Unity Catalog 到 Lakehouse 架构映射、前后代码模式、集群与作业映射、共享与 MLflow 迁移路径、迁移后验证与故障排查。严重级别分 Blocker、Warning、Info:Blocker 需停止并交由用户决策;Warning 迁移时带评审标记;Info 可直接替换。
必要用法:调用 api.fabric.microsoft.com 的每个请求都必须带 x-ms-fabric-skill: databricks-migration,az rest 用 --headers "x-ms-fabric-skill=databricks-migration",包括每次 LRO 轮询、fabric_lro 与重试;代码片段未含也要补上。按阶段只加载所需参考文件,不要一次读取全部资源。查找工作区或项详情时先列出再用 JMESPath 过滤。
关键映射与限制:dbutils.* 在 Fabric 不可用,必须整体替换而非用 try/except 或双运行时分支保留;dbutils.secrets.get 换为 notebookutils.credentials.getSecret(keyVaultUrl, secretName);dbutils.widgets 无直接等价,改用笔记本参数单元格或 notebookutils.variableLibrary,runtime.context 只提供执行元数据不含参数;dbutils.library 无等价,改用 Fabric Environments。默认每个 Unity Catalog catalog 映射为一个启用架构的 Lakehouse;仅当多 catalog 合并时才需用户批准的命名策略。DLT 无等价物属 Blocker,需重写为参数化笔记本加管线编排。Delta Sharing 走 OneLake Shortcuts 或外部数据共享;Feature Store 无托管替代。集群初始化脚本仅支持库安装,不完全等价。迁移前应先盘点工作负载、拓扑、安全与数据位置,信息不足时应先提问。集群实例因按会话启动无持久集群;Scala/R 笔记本需换单元格魔法并重写 Databricks 专有 API。具体验证步骤与故障清单见 validation-testing.md 与 migration-gotchas.md。