SuperAPI AI 工具集

refreshing-semantic-model

数据与分析

查看项目

更新于 10-15 20:32

技能介绍

用途:通过 Power BI Enhanced Refresh REST API 与 Fabric CLI,对语义模型执行刷新、监控、校验和故障排查,适用于数据管道中模型数据重载与增量维护。

主要能力:支持七种刷新类型,其中六种经 REST API 提供——full、automatic、dataOnly、calculate、clearValues、defragment;add 仅限 TMSL。可按整个模型、特定表或单个分区设置刷新范围,并配置 commitMode、maxParallelism、retryCount、applyRefreshPolicy、effectiveDate、timeout 等增强选项。

使用方式:先用 fab get 解析工作区与模型 GUID;再用 DAX 查询记录行数、最大日期等基线;通过 fab api -A powerbi 向 groups/$WS_ID/datasets/$MODEL_ID/refreshes 发送刷新请求,如全量刷新 {"type":"full"};随后查询 refreshes?$top=1 获取状态,必要时用 DELETE 结合 requestId 取消;刷新后重跑同一 DAX 查询对比结果。也可使用 scripts/refresh_model.py,支持 --tables、--partitions、--commit partialBatch、--parallelism、--no-policy、--status-only、--poll 等参数。

适用场景:ETL 后刷新模型、大模型两阶段刷新(dataOnly 加 calculate)、增量刷新策略下的选择性分区刷新,以及按维度表先于事实表的故障隔离调试。

限制:增强刷新功能需 Premium 或 Fabric 容量,Pro 容量仅支持全模型标准刷新,每日最多 8 次;取消仅对 Enhanced API 触发的刷新有效。刷新成功但数据未变通常表示上游源未更新,需先运行 ETL。部分参考资料与脚本细节暂未提供完整内容。