交互模式

2026-05-12
Peer Grønnerup

Applies to:

❌ ~~Tabular Editor 2~~
❌ ~~Tabular Editor 3~~
✔ Tabular Editor CLI

Important

Tabular Editor CLI 目前为 有限公开预览版。可使用 Tabular Editor 账户进行评估；预览期间无需许可证。在正式发布之前，命令、标志位和输出都可能会发生变化。 该预览版本将在 2026-09-30 后停止运行。 我们不建议在预览期间将该 CLI 用于生产环境的 CI/CD 流水线。请查看我们的许可协议。

交互模式是一种引导式的读-求值-打印循环（REPL），用于从终端探索模型。对命令行新手来说，这是最温和的入门方式；而在针对单个模型进行临时操作时，它也是一个便捷的 Workspace。

启动会话

要启动会话，请运行以下任一命令：

te interactive                              # Start and connect to a model later
te interactive ./model                      # Start with a local model
te interactive -s MyWorkspace -d MyModel    # Start with a remote model

会话会打印欢迎横幅，显示当前活动模型，并将你带到一个具备模型上下文的提示符下：

Tabular Editor CLI 交互模式会话

如果尚未设置模型，提示符仅为 te>。此时只需使用 connect 打开连接选择器，或使用 connect <path> 或 connect <workspace> <model> 连接到某个 Workspace 中的模型。

会话内命令

REPL 启动后，所有 te 子命令都可用，且无需加上 te 前缀：

ls tables
get "Sales/Revenue" -q expression
query -q "EVALUATE TOPN(5, 'Sales')"
bpa run --fail-on error

与在会话外时一样，每个命令都可以使用 --help：

deploy --help

引号与 DAX 风格路径

REPL 的行拆分器可识别与对象路径相同的引号形式，因此 DAX 形式的引用会被解释为单个参数：

'...' 和 "..." - 用单引号和双引号括起来的分段。引号字符会被剥离；连续的两个引号用于转义，以表示字面量引号。
[...] — 用方括号括起来的分段。 方括号会在生成的参数中保留，因此像 'Internet Sales'[Sales Amount] 这样的路径会以单个令牌的形式传递给命令，路径解析器随后可以将其重新解释为 DAX 引用。出于同样的原因，成对的右方括号 (]]) 也会按原样保留。

get 'Internet Sales'[Sales Amount]   # One argument, DAX form
get [Total Sales]                    # Lone-bracket model-wide lookup
ls 'Net Sales'/'Sales Amount'        # Quoted segments with a slash separator

未闭合的分组会一直延伸到行末，因此误写的起始引号或括号会触发明确的错误，而不会悄悄把内容拆开。

内置 REPL 命令

这些由 REPL 自身处理，而不是常规命令树：

命令	用途
`help` 或 `?`	列出可用命令。
`status` 或 `pwd`	显示当前活动的模型/连接。
`clear` 或 `cls`	清空屏幕。
`exit`、`quit` 或 `q`	退出交互模式。

引导式提示

启用交互模式后，需要补全输入的命令会提示你输入，而不是直接失败。不带子命令运行 auth 时，会打开一个选择界面，让你在 Login / Status / Logout 之间选择；不带 --force 运行 deploy 时，会显示摘要并要求确认（安全的默认值为 n）。

如果想在当前会话中为单个命令禁用提示，传入 --non-interactive。

何时使用交互模式与非交互模式

交互模式 最适合探索、学习 CLI、针对单个模型执行一次性批量编辑，以及演示。
非交互模式（在 te interactive 之外的默认模式）适用于编写脚本、自动化或在 CI 中运行。见自动化和脚本和 @te-cli-cicd。

两者共用同一套命令树——你在 te interactive 中运行的任何命令，只要在前面加上 te 前缀，就可以直接粘贴到 Shell 脚本中。

Table of Contents