支持的文件类型
Tabular Editor 3 使用多种不同的文件格式和文档类型，其中一些并非 Analysis Services 或 Power BI 使用的格式。本文将概述这些文件类型，并逐一介绍它们。
针对多种文件类型都提供了示例文件，基于 learn.tabulareditor.com 的课程 2“Business Case”。
Dataset 文件类型
Tabular Editor 支持语义模型的四种文件类型：.bim、Power BI 文件 (.pbit 和 .pbip)、.json 和 .tmdl。每种文件类型都有各自的特性和限制，下面将逐一说明。
此外，Tabular Editor 3 商业版和企业版支持在进行 Microsoft Fabric Git 集成时使用的 连同支持文件一起保存 功能。这会创建一个文件夹结构，在模型文件旁边生成 .platform 和 definition.pbism 元数据文件，从而实现与 Fabric Workspace 的无缝同步。有关详细信息，请参阅连同支持文件一起保存。
Note
由于 Tabular Editor 3 桌面版 仅用于作为 Power BI Desktop 的外部工具，因此该版本不允许加载和保存语义模型文件。不过，你仍然可以使用 Tabular Editor 2.x 来实现此目的。要详细了解 Tabular Editor 3 各版本之间的差异，请参阅 比较版本。
.bim 文件是一个由嵌套 JSON 组成的单一文件，这种格式称为 TMSL。
这是 Microsoft 支持的语义模型的原始格式。
但它有一个明显缺点：由于它是一个单一的大文件，难以跟踪变更，也不利于采用 Git 源代码管理等良好的团队开发实践。
文件夹中的.bim 文件
Fabric Git 集成：保存并附带支持文件
使用“保存并附带支持文件”选项（Business 和企业版）时，Tabular Editor 会创建与 Microsoft Fabric Git 集成兼容的文件夹结构：
DatabaseName.SemanticModel/
├── .platform
├── definition.pbism
└── model.bim
借助该结构，可将语义模型提交到 Git repository，并与 Fabric Workspace 同步。有关完整文档，请参阅连同支持文件一起保存。
Fabric Git 集成文件
使用保存并附带支持文件功能（Business 版和企业版）时，Tabular Editor 会创建 Microsoft Fabric Git 集成所需的额外元数据文件。这些文件由 Tabular Editor 自动生成和管理。
.platform
.platform 文件包含有关语义模型项的元数据，包括：
- type：将该项标识为 SemanticModel
- displayName：在 Fabric Workspace 中显示的名称（从 Database
Name属性同步） - description：在 Fabric 中显示的说明（从 Database
Description属性同步） - logicalId：自动生成的跨 Workspace 的标识符
这是一个 JSON 文件，除非你了解 Fabric 项目项的格式，否则不要手动编辑。
Note
这种同步适用于元数据包含名称或描述的模型。由 Power BI Desktop 创建的 Power BI Project (PBIP) 语义模型在其 TMDL 中既不包含名称，也不包含描述：两者只存在于 .platform 文件中。
definition.pbism
该 definition.pbism 文件包含语义模型的整体定义和核心设置。这个文件会与模型元数据（存储在 model.bim 或 definition/ 文件夹中）一起使用，提供 Microsoft Fabric 所需的完整语义模型信息。
在保存时勾选 Save with supporting files 选项后，这两个文件会自动创建。生成的文件夹结构（带 .SemanticModel 后缀）可以提交到 Git repository，并与 Fabric Workspace 同步。
有关此功能的完整文档，请参阅保存并包含支持文件。
Tabular Editor 支持文件
支持文件是指 Analysis Services 或 Power BI 不会使用的文件。这些文件则用于支持 Tabular Editor 3 和其他工具中的不同开发工作流。
打开并选中对应的文档或窗口后，你可以用 Ctrl+S 或“文件 > 保存”来单独保存任何辅助文件。
用户选项（.tmuo）
.tmuo 文件存储针对某个模型的、仅在本机生效的个人设置，包括：Workspace 数据库、数据源凭据覆盖、表导入设置、刷新覆盖项以及 AI 权限授予。这个文件和模型放在同一位置，并以模型名称和你的 Windows 用户名命名，这样多个开发者就能在不互相干扰的情况下处理同一个模型。
里面的凭据会使用你的 Windows 用户密钥加密，所以这个文件实际上没法共享使用。将 *.tmuo 添加到 .gitignore。
有关完整内容以及每种模型格式下这个文件的写入位置，见 @user-options。
关系图文件 (.te3diag)
.te3diag 文件是一种文件格式，用于存储使用 TE3 创建的模型关系图。
这些文件可用于记录模型结构与逻辑，方便参与同一项目的其他开发者查看与协作。可以将 .te3diag 文件保存在与模型文件相同的文件夹中，便于访问和查阅。
关系图文件本质上以 JSON 格式存储，并保存在 Tabular Editor 3 扩展中。
DAX 查询文件（.dax 或 .msdax）
DAX 查询是一类表达式，可用于操作和分析语义模型中的数据。 DAX 文件是包含一个或多个 DAX 查询的文本文件。
你可以在 Tabular Editor 3 中保存 DAX 文件，并在之后再次运行这些查询。你也可以在其他支持 DAX 的工具中打开 DAX 文件，例如 DAX Studio。
只有当 Tabular Editor 3 连接到 Analysis Services 实例或 Power BI/Fabric XMLA endpoint 时，才能打开这些文件。
Pivot Grid 布局（.te3pivot）
这些文件包含 Tabular Editor 3 中 Pivot Grid 的布局。它们是简单的 JSON 文件，用于指定 Pivot Grid 中显示哪些字段（度量值、列、层次结构），以及这些字段的排列方式。
只有当 Tabular Editor 3 连接到 Analysis Services 实例或 Power BI/Fabric XMLA endpoint 时，才能打开这些文件。
DAX脚本（.te3daxs）
这些文件是已保存的 DAX脚本（不是查询），用来在 Tabular Editor 中一次处理多个 DAX 对象。例如，修改语义模型中的多个度量值。
C# Script（.csx）
创建和编辑 C# Script 是 Tabular Editor 最能提升效率的功能之一。
这些脚本可以保存为扩展名为 .csc 的文件，并可加载到 Tabular Editor 中，也可以保存为宏。 Tabular Editor 会维护一个用于存储宏的 MacroActions.json 本地设置文件。
这样，脚本就可以重复使用，而不必每次都从头编写。脚本库 是一个很好的去处，可在此查看并复用各类脚本示例；这些示例展示了 C# 的不同特性和功能。
VertiPaq Analyzer 文件（.vpax）
在 Tabular Editor 中，你可以通过 VertiPaq Analyzer 功能导出和导入 .vpax 文件。 .vpax 文件是一种压缩文件，包含有关你的语义模型大小和结构的信息，但不包含实际数据。
你可以用这个文件分析并优化模型性能，而不会暴露敏感数据。例如，你可以使用 DAX optimizer 工具，基于 .vpax 文件获取改进 DAX 公式的建议。
与其他受支持的文件类型不同，创建 .vpax 文件需要在 VertiPaq Analyzer 窗口中通过“导入”和“导出”按钮完成。
Warning
如果你的模型元数据属于机密信息，那么 .vpax 文件也应视为机密，并仅在充分考虑这一点的情况下共享。如果你担心知识产权泄露，Tabular Editor 3 提供了一个用于混淆 VPAX 文件的选项。
混淆
如果你需要将 VPAX 文件交付给第三方(例如顾问或工具供应商)，可以对文件进行混淆，以隐藏模型元数据。具体做法是：在 Vertipaq Analyzer 窗口中，点击“导出”按钮旁边的下拉按钮，然后选择“混淆导出...”选项。
混淆后的 VPAX 文件使用 .ovpax 文件扩展名。
有关 VertiPaq Analyzer 的更多文档，请参阅：sqlbi Vertipaq Analyzer 和 sqlbi Docs: Vertipaq Analyzer
有关 VPAX 文件混淆的更多信息，请参阅：VPAX Obfuscator
本地设置文件
Tabular Editor 会在 "%localappdata%\TabularEditor3" 文件夹中维护多个本地文件。这些文件与 Tabular Editor 3 的功能相关，值得了解。
在团队里共享这些文件会很有用，这样所有开发者都能用到相同的宏和 BPA 规则。
Tip
在 Windows 上，将受版本控制的文件同步到 "%localappdata%\TabularEditor3" 文件夹的原生方法之一，是使用 SymLink。
把所需文件放在 Git 或 OneDrive 里，并为“%localappdata%\TabularEditor3”文件夹创建一个符号链接。不过要注意：如果有多个用户更新同一个文件版本，最后可能会出现同步问题。不过，Tabular Editor 不直接支持这一点，所以要不要这样做请你自行斟酌。
AI 审计日志
仅在安装了 AI 功能组件时显示。 Tabular Editor 会记录 AI 助手 和 MCP 服务器 执行过的操作：请求了哪些权限以及如何回应；运行了哪些工具，以及每个工具是成功、失败还是被拒绝；以及任何已运行或提交供审核的 C# Script 的完整文本。绝不会记录提示词、回复或你模型中的数据值。
文件按天生成，每天一个，默认保留 30 天。在 工具 > 偏好 > AI 功能 下点击 打开审计文件夹，即可打开该文件夹。管理员可以通过 策略 移动该文件夹并更改保留期限。有关每条记录包含的内容，请参阅 @ai-audit-log。
与此文件夹中的其他文件不同，这个文件保存的是记录，而不是设置。不要共享或同步它：这是每台计算机各自的日志，其中包含的脚本可能会暴露你处理过的模型结构。
MacroActions.json
此文件存储你创建或导入的所有宏。你可以将此文件分享给同事，或将其备份到版本控制系统中；也可以将它配置为与包含宏的远程 repository 同步（见上方提示）。
此文件包含软件中使用的每个宏的索引。如果需要更改某个宏的顺序或名称，可以使用文本编辑器手动编辑此文件。不过务必小心，避免在文件中引入错误或不一致而导致文件损坏；编辑前请先创建备份。
BPARules.json
该文件包含 Best Practice Analyzer 规则以及修复表达式。添加和编辑修复表达式的唯一位置就是这个 JSON 文件。建议将 BPA 规则文件纳入版本控制，这样也可以在部署前对语义模型运行 BPA 规则。
你可以在此处下载微软官方的 BPA 规则：PBA Rules
RecentServers.json
包含用户连接过的所有服务器。有时可以手动编辑它，让它“忘记”那些不再相关的旧服务器。
Layouts.json
Layouts 文件会在启动 Tabular Editor 时自动生成。其中包含 Tabular Editor 3 的 UI 布局配置方式的全部信息。
Tip
删除此文件将重置 Tabular Editor 的布局。如果 Tabular Editor 的布局表现不符合预期，一个不错的第一步是先将此文件备份到别处，删除原文件，然后重启 Tabular Editor 3。