dax

DAX

用于在语义模型中编写、调试和优化 DAX 的技能与参考资料。

对象引用

列引用写作 'Table'[Column]：表名始终存在，并且始终用单引号括起来。度量值引用写作 [Measure]，不要加表名前缀。凡是 DAX 或模型元数据中提及对象的地方，都适用此规则：度量值、计算列和计算项表达式、RLS 筛选器、格式字符串表达式、DAX 查询（te query、pbir model -q），以及提及对象的说明或注释。

原因：度量值属于模型，而不是其所在的表，因此将度量值移到其他表时，所有使用它的表达式都无需更改；裸写 [Measure] 也能让读者一眼看出它是度量值，而不是列。一旦两个表具有相同的列名，不带限定符的列引用就会产生歧义；为所有表名加引号，无论名称是否需要引号，都能保持格式一致。

优化

如需系统地优化 DAX 查询性能，请先阅读工作流参考资料：

references/dax-performance-optimization.md — 分层框架（4 个层级）、分阶段工作流、决策指南和错误处理。

详细参考文件（渐进式披露——按工作流指示查阅）：

• references/engine-internals.md — FE/SE 架构、xmSQL、压缩/分段、SE 融合、跟踪诊断
• references/dax-patterns.md — Tier 1 DAX 模式（DAX001–DAX021）+ Tier 2 查询结构（QRY001–QRY004）
• references/model-optimization.md — Tier 3 模型模式（MDL001–MDL009）+ Tier 4 Direct Lake（DL001–DL002）

跟踪捕获和性能分析：

• 本地模型（Power BI Desktop）： 首先使用 Tabular Editor CLI te query（参见 te-cli 技能）；也可使用 connect-pbid 技能，进行 FE/SE 计时（performance-profiling.md）和中间结果检查（evaluateandlog-debugging.md）。
• 远程模型（Fabric Service / XMLA）： 使用 Tabular Editor CLI te query（-s <workspace> -d <model>），通过工作区 XMLA 终结点运行 DAX；参见 te-cli 技能（tabular-editor 插件）。
• Power BI Modeling MCP： 也可用于跟踪和查询；如果你倾向于使用 MCP 工具，可在尝试上述选项后使用它。

相关技能

• semantic-model — 模型设计、构建和审计，包括 DAX 反模式与最佳实践
• connect-pbid（pbi-desktop 插件） — 跟踪捕获、性能分析、EVALUATEANDLOG 调试
• lineage-analysis — 模型变更前的影响分析