Tableau Prep 帮助

以管理员身份从 .exe 文件所在的目录运行命令，或指定计算机上 .exe 文件位置的完整路径。不要从共享目录运行。有关支持的安装程序选项的列表，请参见安装程序选项(链接在新窗口中打开)。有关支持的安装程序属性的列表，请参见安装程序属性(链接在新窗口中打开)。

• tableau_<product_installer_name>.exe 是您所安装的产品和版本的 Tableau 安装程序。

• option1, option2 等是您希望安装过程运行的方式。

• PROPERTY1, PROPERTY2 等允许您指定安装程序在安装过程中应进行的配置设置。

示例：

tableauPrepBuilder-64bit-2026-2-0.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"

此命令在无提示模式下安装 Tableau 版本 2026.2（不显示提示符、UI 或许可证对话框）。它将在不重新启动的情况下完成安装，接受最终用户许可协议 (EULA)，并将错误报告和使用情况报告设置为关闭。

使用提供的产品密钥激活产品。成功时退出并显示代码 0。其他情况下退出并显示错误代码。也接受单破折号 (-activate)。

若要在安装期间激活产品，请添加一个包括安装程序选项 ACTIVATE_KEY "<key>" 的命令行，并在引号中输入产品密钥。

注册产品。也接受单破折号 (-register)。若要通过命令行注册 Tableau，您需要在将运行 Tableau Prep Builder 的每台计算机上预先填充注册表 (Windows) 或 .plist (Mac) 值。

对于 Windows，您可以通过添加包括安装程序选项 REGISTER="1" 的单一命令行，在安装过程中注册产品。

有关详细信息，请参见注册 Tableau Desktop 和 Tableau Prep Builder(链接在新窗口中打开)。

使用许可证的当前维护期的到期日期更新许可证，并停止发送到期消息。成功时退出并显示代码 0。也接受单破折号 (-refresh)。

Windows：使用 --refresh 选项和产品密钥运行 tableau.exe。

MacOS：对 /Applications 路径中的 Tableau 对象运行 -refresh 选项。

停用提供的产品密钥，以便可以重复使用。也接受单破折号 (-return)。

Windows：使用 -return 选项和产品密钥运行 tableau.exe。

MacOS：对 /Applications 路径中的 Tableau 对象运行 -return 选项。

从给定文件加载应用程序配置设置。可以多次指定以支持分层配置，例如当您有每个人都使用的全局代理服务器配置，以及用于流程的特定数据库配置时。

.json 文件示例:

{
 "connection-sources":[
  {
	"endpoint":"prod-db-server.company.com",
	"username":"service_account_admin",
	"password":"secure_password_123"
	}
 ]
}

示例命令：

Windows："C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --settings-file "C:\ProgramData\Tableau\global-proxy-config.json" --settings-file "C:\Users\jsmith\AppData\Roaming\Tableau\db-config.json"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --settings-file "/Library/Tableau/global-proxy-config.json" --settings-file "/Users/jsmith/Library/Application Support/Tableau/db-config.json"

设置存储库目录。默认情况下，在安装过程中，Tableau Prep 会在您的“文档”文件夹中创建一个名为“我的 Tableau Prep 存储库”的文件夹。此文件夹包括流程、数据源、连接以及日志文件的文件夹，以及临时缓存。在服务器或自动化环境中，可以使用此命令指定备用存储库位置，并将流程运行指向该位置。

示例：

Windows："C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --repository-location "D:\Tableau_Data\My_Prep_Repo"

MacOS：/Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --repository-location "/Users/jsmith/Documents/My Tableau Prep Repository"

用于存储 Electron 应用程序数据的目录。

--repository-location 管理您的业务资产（日志和数据），而 --user-data-directory 管理应用程序的内部引擎。

作为管理员，如果您在多个进程需要隔离应用程序状态的高并发环境中运行 Tableau Prep Builder，或者在无头服务器上排查持久性会话锁定错误时，请使用此标志。

注意：运行该命令时，它会自动创建 --user-data-directory 中指定的文件夹。但是，运行脚本的用户帐户必须具有该父目录的“写入”权限。

示例：

Windows： "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --user-data-directory "D:\Tableau_Data\Prep_AppData"

MacOS：/Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --user-data-directory "/Users/jsmith/Library/Application Support/Tableau Prep"

打开指定的 .tfl 流程文件。如果文件路径包括空格，请使用双引号。

示例：

Windows："C：\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" -tfl "C：\用户\jsmith\文档\我的流程\Clean_Sales_Data.tfl"

MacOS：/Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder -tfl "/Users/jsmith/Documents/My Flows/Clean_Sales_Data.tfl"

打开指定的 .tflx 打包流程文件。

示例：

Windows："C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --tflx "C:\Users\jsmith\Desktop\Quarterly_Report.tflx"

MacOS：/Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --tflx "/Users/jsmith/Desktop/Quarterly_Report.tflx"

包含数据源和服务器凭据的 .json 文件的路径。

如果使用远程连接，Tableau Prep Builder 将使用流程文件和凭据 .json 文件中的信息来运行流程。有关详细信息，请参见 凭据 .json 文件要求(链接在新窗口中打开)。

如果连接到 Snowflake 数据库，请确保包括任何特定参数，例如角色、仓库，有时还要包括 OAuth 令牌或外部浏览器身份验证。

.json 设置文件示例 - Snowflake：

{
 "connection-sources":[
  {
	"endpoint":"company_account.snowflakecomputing.com",
	"username":"SVC_TABLEAU_PREP",
	"password":"EncryptedPassword123",
	"attributes":{
	 "warehouse": "DATA_LOAD_WH",
	 "role": "TRANSFORM_ROLE"
	}
  }
 ]
}						

示例：

Windows： "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -c "path\to\[your credential file name].json" -t "path\to\[your flow file name].tfl"

MacOS： /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

覆盖流程中默认参数值的 .json 文件的路径。这是一个独立于您的 credentials.json 文件的文件，包含您的参数名称和值。

有关详细信息，请参见凭据 .json 文件要求(链接在新窗口中打开)中的“运行包含参数值的流程”。

示例：

Windows："\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" -p|--parameters parameters.override.json

MacOS：/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl -p|--parameters parameters.override.json

如果在服务器上未启用 Tableau Prep Conductor 来计划流程运行，则可以通过增量刷新使用此命令来运行流程。有关详细信息，请参见“在启用增量刷新的情况下运行流程”。

示例：

Windows："\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --incrementalRefresh -t "path\to\[your flow file name].tfl"

MacOS：/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --incrementalRefresh -t path/to/[your flow file name].tfl

启用调试模式。在存储库文件夹中生成详细日志以进行故障排除。日志文件存储位置：我的 Tableau Prep Builder 存储库\Command Line Repository\Logs

示例：

Windows："\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --debug -t "[your flow file name].tfl"

MacOS：/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --debug -t “[your flow file name]”.tfl

禁用 SSL 证书验证（对于某些内部服务器环境很有用）。在 MacOS 上运行此选项时，可能会显示一个对话框，询问钥匙串用户和密码。

从 Tableau Prep Builder 版本 2019.3.2 开始，您可以传入此附加参数来禁用此钥匙串对话框。

示例：

MacOS：/Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -dsv -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

显示命令行选项的帮助菜单。