用途:从 VS Code 将笔记本发布到 Microsoft Fabric,基于 Azure DevOps Git 集成完成同步,面向 Fabric 笔记本的 DevOps 发布流程。
主要能力:基于 MD5 哈希对比源与工作树,仅同步实际变更的笔记本,可按模式过滤(如 -NotebookFilter "Bronze");自动向 CHANGELOG.Notebook 追加时间戳、用户、提交信息与变更笔记本;校验 Az 模块、Azure 登录、工作树及 Git 远程配置;支持选择性同步。提供三种方式:Sync-ToFabric.v2.ps1(Git 方式,含变更检测与 CHANGELOG,用于生产)、Publish-ToFabric.ps1(直连 API,绕过 Git,用于开发迭代)、手动复制→提交→推送→门户同步(回退)。
用法:配置位于 fabric-governance/scripts/fabric-publish/fabric-publish.config.json,包含 workspace、git(adoRemoteName、branch、worktreeRelativePath)、changelog 设置。常用命令示例(保持原样):cd fabric-governance\scripts\fabric-publish;.\Sync-ToFabric.v2.ps1 -CommitMessage "Update Bronze layer";.\Sync-ToFabric.v2.ps1 -NotebookFilter "Bronze" -CommitMessage "Bronze fixes";.\Sync-ToFabric.v2.ps1 -DryRun;.\Sync-ToFabric.v2.ps1 -Force -CommitMessage "Re-sync all";.\Sync-ToFabric.v2.ps1 -SkipApi -CommitMessage "Stage for review"。
适用场景:Fabric 笔记本的变更发布与追踪,生产环境建议使用 v2 脚本;开发阶段可用直连 API 发布。需要工作树、Git 远程与 Azure 登录等前置条件。
限制:Fabric 的 Git 集成仍在成熟中,同步行为、支持的项类型(并非所有 Fabric 项类型都支持 Git 同步)以及 GitHub 支持是否扩展均可能变化,需查阅 Fabric Git 集成文档。其他平台支持、价格与许可信息暂未提供。已知错误处理包括工作树未找到需执行首次设置、未登录 Azure 需 Connect-AzAccount、未装 Az 模块需 Install-Module -Name Az、401 需重新登录、403 需检查工作区 Admin/Member 角色、同步冲突需在 Fabric 门户解决。