用途:在 PBIP 项目里直接编写或修改 TMDL(表格模型定义语言)文件,涵盖度量值、列、表、关系、角色、calculation group、共享表达式等。也可做 BIM 到 TMDL 的转换。属于最后手段:直接编辑缺少 Tabular Editor CLI、Power BI MCP server 或 connect-pbid 的校验、原子性和 DAX 查询能力。
适用时机:Git 仓库中的 PBIP 文件而未打开 Power BI Desktop;未安装 Tabular Editor CLI 或 MCP server;只需文本级快改(描述、格式字符串、显示文件夹)。
主要规则:缩进有语义,深度等于嵌套层级;PBIP 每层一个制表符。/// 紧邻下一行声明,设置其 Description,不能有空行,多个 /// 合并为一条描述;// 为普通注释。名称含空格、点、等号、冒号、单引号或数字开头时用单引号,简单名不加引号。M 表达式与表共享命名空间,重名会导致加载失败,常见做法是给 M 查询加 Query/ Source 后缀。
文件类型:model.tmdl、database.tmdl、relationships.tmdl、expressions.tmdl、functions.tmdl、roles/<RoleName>.tmdl、perspectives/<Name>.tmdl、tables/<Name>.tmdl、cultures/<locale>.tmdl、dataSources.tmdl。对象须嵌在正确父级中。
限制:不校验 DAX 语法、引用完整性或属性值合法性,错误只在下次加载或 XMLA 部署时暴露。使用前建议用 pbip-validator agent 检查。资料中未提供具体安装命令、收费、价格或效果数据。