用途:在 Microsoft Fabric 工作区内以命令行方式创建、获取、更新和部署 Power BI 语义模型,主要面向 TMDL 格式的模型定义操作,并覆盖刷新、数据源、参数、权限与部署管道等管理任务。
主要能力:使用 az rest 调用两套 API——Fabric Items API(https://api.fabric.microsoft.com)用于语义模型定义的创建/获取/更新/删除、列出条目与 LRO 轮询;Power BI Datasets API(https://analysis.windows.net/powerbi/api)用于刷新、数据源、参数、权限和部署管道。支持 TMDL 文件结构(definition.pbism、database.tmdl、model.tmdl、tables/*.tmdl)、Import 与 Direct Lake 表、关系、层次结构、计算组、安全角色、翻译等建模内容。
使用方式:先运行 az version 检查环境;首次会话需执行更新检查。用 az login 认证,调用时始终传 --resource 指定正确受众,否则返回 401。TMDL 内容需 base64 编码后放入 definition.parts,POST 创建后按 Operation-Id 轮询 LRO 至终态。更新定义时必须包含全部部件(含未修改的),且不得包含 .platform。
限制:不支持报表创建(需 PBIR 格式);TMDL 不支持 // 注释与 description 属性,应使用 ///;新建对象不要手写 lineageTag;小改动建议改用 powerbi-modeling-mcp;创建前需确认工作区已分配容量。具体安装与更多细节以官方资料为准,部分内容暂未提供。