Tabular Editor CLI（有限公开预览）
Tabular Editor CLI (te) 是适用于 Power BI 和 Analysis Services 语义模型的跨平台命令行工具。 它以单个自包含的可执行文件形式在 Windows、macOS 和 Linux 上运行，并基于驱动 Tabular Editor 3 的同一基础构建。
使用 Tabular Editor CLI，你可以在终端中检查、编辑、验证、部署、刷新和测试语义模型——可针对本地 TMDL 或 BIM 文件、Power BI Desktop，或 Fabric 和 Power BI Service Workspace 中的语义模型。
与仅限 Windows 的 TabularEditor.exe 命令行选项（TE2）不同——后者主要用于从桌面端二进制文件自动执行 C# Script 和宏——te 是专为跨平台打造的 CLI，提供结构化输出、可预测的退出代码以及交互式 shell。 这让现有的 TE2 CLI 难以很好覆盖的场景成为可能：在 macOS 和 Linux 上通过终端完成模型工作、由 AI 代理直接驱动模型更改，以及无缝接入任何现代 CI 运行器。
Important
Tabular Editor CLI 目前为 有限公开预览版。 可使用 Tabular Editor 账户进行评估；预览期间无需许可证。 在正式发布之前，命令、标志位和输出都可能会发生变化。 该预览版本将在 2026-09-30 后停止运行。 我们不建议在预览期间将该 CLI 用于生产环境的 CI/CD 流水线。 请查看我们的许可协议。
面向三类受众打造
每个命令都围绕三大设计支柱构建：
- 结构化输出 — 除默认的可读文本外，还支持 JSON、CSV、TMDL 和 TMSL。
- 非交互模式 — 全局
--non-interactive标志可禁用提示并快速失败。 - 清晰的错误信息 — 写入 stderr，并使用可预测的退出代码。
这三者结合起来，让同一个二进制文件能够很好地服务于三类截然不同的用户：
- 人 — 用脚本批量编辑、在终端中探索模型，并在 shell 管道中组合命令。
- AI 代理 — 更节省 token 的 JSON、机器可解析的错误结构，以及无需解析 stdout 就能表明成功或失败的退出代码。
- CI/CD 管道 — 非交互式执行、GitHub Actions 和 Azure DevOps 注释，以及兼容 VSTEST 的测试结果。
Note
当与代理配合使用 TE CLI 时，请使用面向 AI 编码代理的 TE CLI skill，它对 TE CLI 进行了端到端封装。
CLI 可以做什么
CLI 将 50 多个命令划分为 10 个类别。 每个命令族都对应语义模型生命周期中的一个具体阶段。
有关每个命令的语法、选项和示例的完整命令参考，请参阅 @te-cli-commands。 点击表中的任意示例命令，直接跳转到对应的参考条目。
| 命令族 | 功能 | 示例命令 |
|---|---|---|
| 模型 I/O | 加载、保存、转换和初始化模型 | te load、te save、te init |
| 模型编辑 | 获取/设置属性，添加/删除/移动对象 | te set、te add、te rm、te mv |
| 检视 | 列出对象、搜索、比较差异、分析依赖关系 | te ls、te find、te diff、te deps |
| 分析与质量 | 验证、运行 BPA、格式化 DAX、分析存储 | te validate、te bpa run、te format、te vertipaq |
| 执行 | 运行 DAX 查询、C# Script 和宏 | te query, te script, te 宏 |
| 部署与刷新 | 部署到 Workspace、触发刷新、执行增量刷新 | te deploy、te refresh、te incremental-refresh |
| 测试 | 断言测试、快照、A/B 比较 | te test run |
| 连接与身份验证 | 连接到 Workspace，管理身份验证和配置文件 | te connect, te auth, te profile |
| 配置 | 设置与许可 | te config |
| Shell | 交互模式、会话状态、Shell 自动补全 | te interactive, te session, te completion |
开始使用
- 注册或登录：前往 tabulareditor.com 注册 Tabular Editor 帐户或登录。
- 下载并安装：Windows、macOS 和 Linux 的说明见 @te-cli-install。
- 进行身份验证：运行
te auth login，即可连接到 Power BI 或 Fabric。 见 @te-cli-auth。 - 运行第一个命令：
te --help会列出所有命令；te <command> --help会显示详细选项。
初次查看实时模型只需两条命令：
te auth login
te ls -s MyWorkspace -d MyModel
预览提示
默认情况下，每个命令都会在 stderr 中输出一个黄色的预览横幅：
要隐藏预览提示，只需运行：
te config set hidePreviewNotice true
Warning
在预览结束日期（2026-09-30）前 14 天内，无论 hidePreviewNotice 如何设置，每次执行命令时该横幅都会再次出现。 这可确保在 CLI 停止运行之前，你能提前看到醒目的警告。
许可概览
在有限公开预览期间，CLI 无需许可证；你只需要一个 Tabular Editor 账户即可下载。 在正式发布 (GA) 时，CLI 将需要许可证；定价仍在最终敲定中，并会在 GA 前公布。
反馈与社区
在预览期间，Bug Report、功能请求和一般讨论都在 GitHub 上的公开 TabularEditor/CLI repository 中进行：
- Issues - 用于 Report bug、提出功能请求，并跟踪已知问题。
- Discussions - 提问、分享反馈，并和其他早期用户交流使用技巧。
这个 repository 不托管 CLI 源代码；设立它是为了让社区在预览期间能通过一个公开渠道联系到我们。