SuperAPI AI 工具集

fabric-capacity

通用与其它

查看项目

更新于 10-15 20:32

技能介绍

用途:该技能在用户询问 Fabric 容量为何繁忙、被限流、达到 90% 或 100%、或是什么在消耗 CU 时自动调用。它从 Microsoft Fabric Capacity Metrics 语义模型读取容量利用率和按项 CU 数据,并可启动或暂停容量。建议同时调用 fabric-cli 技能,其 references/capacity-cost.md 覆盖预算计算、平滑与限流。

数据位置:live(DirectQuery,CapacityMetricsCES 连接器)包含 CU Detail(每 30 秒时间点,Interactive、Background、CU limit、SKU)、Timepoint CU Detail、Metrics By Item 系列(按项 CU 秒、时长、操作、用户)和 System Events(暂停、恢复、状态变化)。import 表仅在模型刷新后更新,Pro 工作区每天 8 次刷新。Azure Monitor 没有 Microsoft.Fabric/capacities 指标命名空间。需要实时性的内容必须使用 DirectQuery 表。

使用方式:模型位于 Pro 工作区,无 XMLA 端点,te 无法连接,需通过 fab 的 executeQueries 查询。DirectQuery 表须在 DEFINE 块中传入容量作为 M 参数,否则连接器失败且错误类似凭据问题。容量利用率 % =(Interactive + Background)/(Base capacity units * 30);CU limit 是比率 1.0,不是分母。最新时间点可能包含整个后台操作,应读前一个时间点。容量 ID 可用 fab api -A powerbi capacities 获取。含 / 的名称会破坏 fab 路径,应使用 ID。

启动与暂停:用 fab get ".capacities/<name>.Capacity" -q properties.state 查看状态(Active | Paused,约 10 秒),fab start 和 fab stop 命令控制。

限制:数据源 OAuth 刷新令牌 90 天不用会过期,导致计划刷新停止且模型静默变旧;旧版应用可能无法支持 DirectQuery,需更新;凭据问题可能导致 DirectQuery 失效;凭据账号必须是所查询容量的容量管理员;后台作业按 24 小时平滑计算。