用途:这是受支持的只读 Microsoft Fabric Power BI 语义模型(原 Power BI 数据集)查询交互路径,通过 CLI 执行 DAX 查询并做元数据发现。
主要能力:
- 元数据发现:使用 DAX INFO.VIEW.* 与 INFO.* 函数探索模型结构,如 INFO.VIEW.TABLES、INFO.VIEW.COLUMNS、INFO.VIEW.MEASURES、INFO.VIEW.RELATIONSHIPS、INFO.PARTITIONS、INFO.DEPENDENCIES 等。
- 查询执行:通过 ExecuteQuery 能力提交,载荷包含 artifactId(目标语义模型标识)与 daxQuery(DAX 查询文本)。
- 辅助参考:涵盖工作区与项查找、认证与令牌获取、控制面 REST API、OneLake 数据访问、作业执行、容量管理等主题(分散于 COMMON-CLI.md、COMMON-CORE.md、SKILL.md、discovery-queries.md)。
使用方式与约束:
- 会话首次使用前须先执行更新检查(check-updates 技能,或比较本地与远程 package.json 版本),同一会话内已检查则跳过。
- 工作区与语义模型标识须动态解析,不得硬编码 ID;可通过列出工作区/项后使用 JMESPath 过滤。
- 建议先做范围估算,再逐步发现模式:优先 INFO.VIEW.*,用 SELECTCOLUMNS 与 FILTER 缩小结果,避免拉取全量模式。
- 保持只读:仅做元数据发现与分析型 DAX 查询,禁止模型变更操作。
- INFO.VIEW.* 与数据查询对具备读权限的用户可用;其他 INFO.* 函数可能需要更高权限。
- 不要用 INFO 函数获取角色成员,应改用 Power BI REST API。
限制:ExecuteQuery 目前为临时实现,预计在发布前替换为公开 HTTP 端点;若 MCP 服务器未注册或工具元数据过期,会提示不可用。费用、平台支持范围等信息暂未提供。