用途:探索 Power BI 语义模型架构,编写并测试 DAX 查询,最终把验证过的查询整理为应用代码库中的 .dax 文件。
主要能力:采用渐进式架构发现策略,按需获取元数据,顺序为范围估算、表、列、度量值、关系,必要时再查高级元数据。使用 INFO.VIEW 系列函数(读权限)获取表、列、度量值、关系;INFO 系列函数(可能需要更高权限)获取计算组、日历、用户定义函数、变体等。支持用 SELECTCOLUMNS 与 FILTER 缩小结果,并生成、测试 DAX 查询。
使用方式:先用范围估算查询统计模型规模,再按需发现相关表、列、度量值、关系。生成 DAX 后必须通过 npx fabric-app-data query <alias> --query '<DAX>' 测试;也可用 --file 重测已有 .dax 文件。CLI 默认最多返回 1000 行,超出时输出 _cliWarning。验证后的查询保存到 src/queries/,每个查询配 .dax 与 Vega-Lite .json,并用 barrel .ts 导出工厂函数,返回 { connection, query, columnMetadata, vegaLiteSpec }。列元数据键须与 CLI 输出列名逐字一致。
适用场景:需要理解语义模型结构、编写 DAX 查询、做时间智能分析(YTD、同比、滚动窗口、期初期末余额)并接入应用可视化的场景。
限制:不得使用 GetSemanticModelSchema、DiscoverArtifacts、GenerateQuery 等 MCP 工具;避免在 DAX 中使用 SQL 关键字;EVALUATE 不能直接搭配标量函数;无聚合且分组列跨多表时不用 SUMMARIZECOLUMNS;高级 INFO 函数若权限失败则本会话跳过。CLI 需先 az login,未安装 Azure CLI 需从 https://aka.ms/install-azure-cli 安装。