SuperAPI AI 工具集

power-bi-deployment

部署与运维

查看项目

更新于 10-15 23:42

技能介绍

用途:通过 pbi-cli 管理 Power BI 语义模型的生命周期,包括 TMDL 导出/导入、事务、快照对比与版本控制。

主要能力:导出整个模型为 TMDL 文件夹或 TMSL JSON;将 TMDL 文件夹导入已连接模型;用 diff-tmdl 比较两个导出快照,输出表、关系、模型级属性的增删改摘要,并自动过滤仅 lineageTag 变化;列出数据库;用事务原子提交或回滚多步变更;按 Full、Automatic、Calculate、DataOnly 类型刷新单表;以 --json 输出便于脚本化。

使用方式:先安装并连接,命令为 pipx install pbi-cli-tool、pbi-cli skills install、pbi connect。连接支持自动检测本地端口、显式端口(pbi connect -d localhost:54321)和命名连接(--name dev),可用 pbi connections list、pbi connections last、pbi disconnect 管理。典型流程:pbi database export-tmdl ./model/ 导出后提交 Git,再 pbi connect 与 pbi database import-tmdl ./model/ 导回。

适用场景:模型版本控制、部署前检查、CI/CD 中比较 PR 对模型的改动、多环境切换。

限制与注意:import-tmdl 对整个文件夹并非原子操作,中途解析失败会留下部分变更,建议用事务包裹或先备份;diff-tmdl 会过滤仅 lineageTag 变化,可能掩盖下游依赖的重新标记;命名连接跨会话持久,执行破坏性命令前先 pbi connections last;table refresh --type Full 会重建计算列和关系并锁定模型,生产刷新宜用 DataOnly;TMSL 为单个 JSON,不适合 Git 差异,版本控制应用 TMDL;transaction rollback 只回滚元数据,不回滚已执行的数据刷新。