SuperAPI AI 工具集

refresh-semantic-model

数据与分析

查看项目

更新于 10-15 20:32

技能介绍

用途:当用户要求刷新语义模型或数据集时自动调用,用于管理、优化和排查 Power BI 语义模型刷新。

主要能力:通过 Enhanced Refresh REST API 与 Fabric CLI 触发、监控、验证和排查刷新。刷新范围可为整个模型、指定表或单个分区。REST API 提供六种刷新类型(full、automatic、dataOnly、calculate、clearValues、defragment),第七种 add 仅限 TMSL。其中 dataOnly 会清空依赖对象但不重算,需随后执行 calculate 恢复。

使用方式:先用 fab get 取得工作区与模型 GUID,再以 fab api -A powerbi 调用 refreshes 接口,例如完整刷新 {"type":"full"},或指定表/分区对象;查询状态用 refreshes?$top=1,取消用 DELETE refreshes/<requestId>(仅限 Enhanced API 触发的刷新)。也可使用 scripts/refresh_model.py,如 uv run scripts/refresh_model.py -w $WS_ID -m $MODEL_ID,支持 --tables、--partitions、--poll、--status-only 等参数。建议流程为刷新前用 DAX 记录基线、触发刷新、轮询状态、刷新后重跑同一 DAX 比对行数或最大日期。

适用场景:大数据量模型的两阶段刷新、增量刷新的选择性分区刷新、ETL 之后触发刷新,以及按表隔离失败原因。表级/分区级刷新、commit 模式、并行度、取消和超时覆盖等增强功能需 Premium 或 Fabric 容量;Pro 仅支持整模型标准刷新。要求工作区贡献者及以上权限,并已执行 fab auth login。

限制:刷新只能拉取源端已有数据,若来源陈旧,刷新会成功但无新数据。具体容量上限、超时与故障排查细节请参见技能所附 references 文件;资料未提供的其他信息暂未提供。