用途:为 Power BI 语义模型编写与测试 DAX 查询,指导生成符合语法规则的查询,并在实际执行中迭代验证。
主要能力:覆盖 DAX 语法规则(EVALUATE/DEFINE/ORDER BY/START AT)、核心函数(CALCULATE、CALCULATETABLE、SUMMARIZECOLUMNS、ALL/ALLEXCEPT、TREATAS)、BLANK 语义、常见错误与反模式,以及时间智能(YTD/QTD/MTD、同比、滚动窗口、期初期末余额)。要求优先复用模型已有度量值,列引用用 'Table'[Column]、度量值用 [Measure],DEFINE 块不加逗号,避免在 DAX 中混用 SQL 关键字,避免 EVALUATE 直接搭配标量函数。
使用方式:先用 npx fabric-app-data query <alias> --query '<DAX>' 执行生成的查询,检查列名、数据类型、行数与实际值;出错时对照参考文档修正后重测。已有 .dax 文件可用 --file 参数重测,如 npx fabric-app-data query <alias> --file src/queries/revenue.dax。CLI 默认最多返回 1000 行,超出时输出含 _cliWarning 字段,需要更多数据应细化筛选或聚合。
适用场景:涉及期间计算、同期对比、滚动窗口、期初/期末余额或自定义日期区间时查阅时间智能参考;分组查询优先用 SUMMARIZECOLUMNS,配合 TREATAS 传筛选参数。
限制与依赖:CLI 查询需登录 Azure CLI(az login),未安装可从 https://aka.ms/install-azure-cli 获取;别名缺失可运行 npx fabric-app-data list 查看、npx fabric-app-data add 注册。时间智能函数依赖正确配置并标记为日期表的日期表,缺失会导致结果错误。执行结果与运行中应用一致,但 CLI 存在 1000 行截断限制。未提供定价、平台支持范围等其它信息。