用途:面向已读过其官方文档的用户,通过 MCP 服务器以只读方式消费 Microsoft Fabric Power BI 语义模型。核心是两件事:发现语义模型元数据,以及执行分析型 DAX 查询。不进行任何模型变更操作。
主要能力:使用 MCP 工具 DiscoverArtifacts 按名称查找语义模型 GUID,用 GetSemanticModelSchema 获取表、列、度量值定义,用 ExecuteQuery 运行 DAX。元数据发现推荐先用 INFO.VIEW.TABLES(),再扩展至 INFO.VIEW.COLUMNS()、INFO.VIEW.MEASURES()、INFO.VIEW.RELATIONSHIPS();更深入可使用 INFO.* 系列函数(如 INFO.PARTITIONS、INFO.MODEL、INFO.DEPENDENCIES 等),并建议用筛选与投影缩小结果。
使用方式:ExecuteQuery 参数为 artifactId(语义模型 GUID)、daxQueries(1 到 4 条 DAX 查询,每条含单个 EVALUATE 语句)、maxRows(可选,默认 250,上限 1000)。这些是 MCP 工具调用,不是 shell 命令,不应使用 az rest、Get-Command 或 PowerShell 脚本来发现或调用。需动态解析工作区与模型标识,不要硬编码 ID。本技能要求每次会话首次使用时先运行 check-updates 技能;在 GitHub Copilot CLI / VS Code 中调用该技能,在 Claude Code 等环境中比较本地与远程 package.json 版本,已检查过则可跳过。
限制与注意:DAX 数据查询和 INFO.VIEW.* 对任何拥有模型读取权限的用户可用,其他 INFO.* 函数可能要求更高权限,可能返回授权错误。INFO.ROLEMEMBERSHIPS() 不能可靠返回角色成员,因角色成员在部署后由服务端 Entra ID 分配。若 ExecuteQuery 不可用,需确认 FabricIQ MCP 服务器已注册并暴露该工具。元数据输出量可能过大,建议先估算范围再缩小投影与过滤。更完整查询目录与依赖发现示例见 discovery-queries.md。前置资料为 COMMON-CORE.md 与 COMMON-CLI.md。