1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | databricks-migration(Microsoft Fabric Skills 合集子技能) |
| 作者/维护者 | Microsoft(skills-for-fabric 官方仓库) |
| 来源链接 | https://github.com/microsoft/skills-for-fabric/tree/main/skills/databricks-migration |
| 许可证 | MIT(数据来自 GitHub API) |
| GitHub Stars | 885(合集仓库整体数字,来自 GitHub API;不代表本技能个体热度,见第 6 章说明) |
| Forks | 241(数据来自 GitHub API) |
| 最新版本 | v0.3.9(2026-07-23,数据来自 GitHub 提交记录) |
| 安装方式 | GitHub Copilot CLI 插件市场 / npx skills add / 直接克隆仓库 |
2. 功能介绍与亮点
databricks-migration 帮助工程师把 Databricks 上的 notebook、Job、Unity Catalog 等资产迁移到 Microsoft Fabric。核心内容是一份详尽的 dbutils → notebookutils 对照表,覆盖文件系统操作、密钥获取(Secret Scope → Key Vault URL)、notebook 运行与退出、widget 参数替换、以及运行时库安装替换为 Fabric Environments 等具体场景。
除 API 级映射外,技能还给出架构级迁移地图:Databricks 全用途集群/Job 集群如何对应 Fabric 的 Starter Pool/Custom Pool 与 Spark Job Definition;Unity Catalog 三层命名空间如何收敛为 Fabric Lakehouse 的两层 schema;Delta Live Tables 没有直接对应物,需要重写为带参数的 notebook 加 Data Pipeline 编排;MLflow 追踪代码基本可以直接迁移,只需删除 set_tracking_uri。技能正文附带三份独立资源文档(dbutils 完整映射表、Unity Catalog 迁移细节、前后代码模式对照),并给出明确的 Must/Prefer/Avoid 清单,例如强调“不要把 dbutils 调用藏在 try/except 兼容层里,应彻底替换”。
同一 Fabric Skills 合集中还包含 powerbi-report-authoring、semantic-model-authoring、dataflows-authoring-cli 等技能,它们面向“在 Fabric 内创建/管理原生对象”;这个技能反过来面向“从竞品平台迁移过来”,服务的是正在评估或执行 Databricks→Fabric 迁移的团队,场景更聚焦也更稀缺。
3. 适用场景
所属分类:数据分析与可视化
适合已经决定或正在评估把数据平台从 Databricks 迁移到 Microsoft Fabric 的数据工程师与平台团队——典型场景包括:把生产 notebook 中的 dbutils 调用批量替换为 notebookutils、把 Unity Catalog 的三层目录结构重新设计为 Fabric Lakehouse schema、把 Databricks Jobs 的 DAG 编排改写为 Fabric Data Pipeline、评估 Delta Live Tables 管道该如何重写。尚未使用 Databricks、纯 Fabric 原生开发的用户用不上这个技能,应选同合集中的 authoring 类技能。
4. 跨Agent兼容性
- Claude Code:原生支持。仓库根目录内置
CLAUDE.md,克隆后自动被 Claude Code 读取;官方发布说明明确将 Claude 列为受支持的客户端之一。 - Codex:原生支持。仓库根目录内置
AGENTS.md,Codex/Jules/OpenCode 会自动发现该文件。 - OpenClaw:未验证——未在仓库文档或发布说明中找到相关信息。
- Hermes Agent:未验证——同上。
主要安装路径是 GitHub Copilot CLI 的插件市场机制(/plugin install),是作者优先适配的客户端。
5. 推荐理由
它把“Databricks 迁 Fabric”这件事从零散的手动查表变成了结构化、可直接照抄的对照文档——对被要求评估或执行这类迁移的团队,能省下大量翻官方文档、逐个 API 试错的时间,widget 参数替换、MLflow 迁移这类容易踩坑的细节都给出了明确做法。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Microsoft 出品,repo 整体被 Microsoft Learn 官方文档、Microsoft Fabric 官方博客收录说明,并被第三方技能目录 mcpservers.org 单独列出;但作为合集中的一个子技能,独立于合集之外的第三方讨论有限 |
| 可用性 | 8 | SKILL.md 结构清晰、附三份专项参考文档,给出可直接复制的代码前后对照;2026-07-23 有实质性提交,维护活跃;依赖 Microsoft Fabric 平台访问权限 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单:
① 无内置可执行脚本——内容全部是 Markdown 参考文档,自身不执行 shell 命令,只是指导用户使用官方 az CLI / Fabric REST API 完成迁移操作,用户始终以自己的 Azure 账号权限执行
② 不联网外发数据——技能本身不发起任何网络请求
③ 涉及 Azure AD Token 与 Key Vault 凭据,获取方式在文档中写得很清楚(notebookutils.credentials.getSecret)
④ 未发现可疑指令或隐蔽外发
⑤ Microsoft 官方账号发布,信誉良好
⑥ MIT License,明确开源
⑦ 最近一次实质性提交为 2026-07-23,维护活跃
综合评分(三项均值):7.7
7. 跟同类Skills相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| Fabric Data Warehouse 内置 Migration Assistant(Microsoft 官方产品功能) | Fabric 产品内嵌的图形化迁移向导,面向“把任意来源的 SQL 数据仓库迁到 Fabric Warehouse” | 是产品内置的 GUI 工具而非可安装的 agent skill,聚焦 SQL 脚本自动转换与报错自动修复;本技能面向 notebook/Spark 代码与 Unity Catalog 层面的迁移,覆盖工程代码而非纯 SQL |
| powerbi-report-authoring / semantic-model-authoring / dataflows-authoring-cli(同合集技能) | 面向在 Fabric 内创建、管理原生 Power BI 报表、语义模型、Dataflow | 解决“如何用好 Fabric”,不解决“如何从别的平台搬过来”;本技能专注迁移路径本身 |
8. 用户评价
该技能所属的 Fabric Skills 合集获得了第三方数据分析媒体 Enterprise DNA 的报道,称其为平台集成方面“有意义的一步”,并指出 AI 助手直接操作生产数据资产会让底层数据模型质量变得更关键。截至目前,databricks-migration 这一具体子技能尚未见到独立于该篇报道之外的具名用户评价。
9. 其他补充
无。
10. 安装使用方式
- GitHub Copilot CLI(推荐路径):
/plugin marketplace add microsoft/skills-for-fabric,再/plugin install fabric-skills@fabric-collection(完整包)或按需选择聚焦包 - 通用安装:
npx skills add https://github.com/microsoft/skills-for-fabric --skill databricks-migration - Claude Code / Codex:直接克隆仓库到项目目录,根目录的
CLAUDE.md/AGENTS.md会被自动读取,无需额外配置 - 使用前需要
az login并获取 Fabric REST API 的访问令牌(az account get-access-token --resource https://api.fabric.microsoft.com) - 首次在会话中使用会触发一次
check-updates检查(每个已安装插件最多每 7 天联网检查一次)
11. 注意事项
- 需要 Microsoft Fabric 的工作区访问权限(Fabric 没有永久免费个人层,需 Pro/PPU 授权或试用容量)
- 内容以 API 层面的映射迁移为主,不涉及数据本身的搬迁与连接重路由,复杂的整仓库级迁移仍需结合规划与验证
- Delta Live Tables 没有 Fabric 直接对应物,迁移时需要重写为 notebook + Data Pipeline,属于人工设计工作而非机械替换