SuperAPI AI 工具集

powerbi-report-management

数据与分析

查看项目

更新于 10-16 00:31

技能介绍

用途:在 Microsoft Fabric 工作区中管理 Power BI 报表项及其 PBIR 定义,通过 az rest 调用 Fabric REST API 完成报表项与定义的传输(下载、编码、上传)。不含 PBIR 内容编写。

主要能力:报表项 CRUD(列出、获取属性、创建、更新属性、删除,支持软删除与 hardDelete=true 硬删除);获取报表定义(getDefinition,POST 且支持 LRO,须加 ?format=PBIR);创建与更新定义(创建带 definition 的报表、updateDefinition 覆盖整份定义);将定义各部分 base64 解码到本地文件。

使用方式:所有调用加 --resource "https://api.fabric.microsoft.com",并用 az login 认证;LRO 操作加 --verbose 以捕获 x-ms-operation-id 并轮询至终态。getDefinition 与 updateDefinition 须指定 format=PBIR,仅支持 PBIR,遇到 PBIR-Legacy 应停止并告知用户。updateDefinition 会替换整份定义,必须包含全部 parts(含未修改项)。所有 part payload 用 InlineBase64。definition.pbir 在 Fabric API 中使用 byConnection(semanticmodelid=...),byPath 仅用于本地/Git。解码示例:echo "$payload" | base64 -d > "./report-definition/$path"。安装检查:az version 2>/dev/null || echo "INSTALL: https://learn.microsoft.com/cli/azure/install-azure-cli"。

适用场景:发布本地 .pbip 报表、在 Fabric 工作区间搬运报表定义、批量查询与重命名报表、删除报表。发布本地语义模型时委托对应的语义模型编写技能,完成后解析 semanticModelId 并绑定报表。

限制:本技能只管传输,PBIR 内容编写须交由 powerbi-report-authoring;含加密敏感度标签的报表无法获取定义;创建返回 202 后不得重试 POST 以免重复;收到 202 时须轮询 LRO;每次 api.fabric.microsoft.com 调用须带 x-ms-fabric-skill: powerbi-report-management(az rest 写法 --headers "x-ms-fabric-skill=powerbi-report-management"),LRO 轮询与重试同样需要;本地编辑默认不发布,除非用户明确要求;操作完成后清理临时文件;需比对 TMDL 与 PBIR 绑定名称。费用、价格、平台支持情况未提供。