Tableau Cloud 帮助

Tableau 提供了 tabcmd 命令行实用工具，您可以使用它在 Tableau Cloud 站点上自动完成站点管理任务。例如，创建或删除用户、项目和组。

重要信息：tabcmd 1.0 不支持多重身份验证 (MFA)。若要将 tabcmd 与 Tableau Cloud 一起使用，请使用 Tableau tabcmd 2.0(链接在新窗口中打开)（新窗口）。有关 Tableau Cloud 和 MFA 的详细信息，请参见多重身份验证和 Tableau Cloud。

安装 tabcmd

注意：这些说明用于安装 tabcmd 1.0 命令行实用程序。若要安装 tabcmd 2.0 命令行实用程序，请转到 Tableau tabcmd(链接在新窗口中打开)（新窗口）。

将 Tableau Server 或 Tableau Cloud 升级到新版本时，如果需要 tabcmd 的更新版本，您可以从 Tableau 网站上“Tableau Server 版本”页面下载该版本。

对于 Tableau Server：我们建议下载择与您的服务器版本匹配的版本。对于 Tableau Cloud，我们建议您始终下载最新版本，以避免版本不兼容导致的问题。在任一情况下，使用 tabcmd 的过时版本可能会导致错误和不可预知的结果。

1. 打开 Web 浏览器并转到 Tableau Server 版本(链接在新窗口中打开)页面。即使您使用 Tableau Online，也转到此页面。

2. 如果您使用的是：

   • Tableau Cloud，请使用 Tableau tabcmd 2.0(链接在新窗口中打开)（新窗口）。
   • Tableau Server（Windows 或 Linux）：请选择与您的服务器版本匹配的版本。

   在任一情况下，如果展开的信息显示维护版本，请选择最新维护版本，或选择与您的服务器版本匹配的维护版本。

   

   这将带您进入发行说明页面（名为“已解决问题”），您可以在其中阅读有关安全改进和已解决问题的信息。

3. 滚动到已解决问题下的“下载文件”部分，选择与您将从中运行 tabcmd 命令的计算机兼容的 tabcmd 下载链接。 

   

   其余步骤将此计算机称为“tabcmd 计算机”。

4. 将安装程序保存到 tabcmd 计算机，或保存到可从该计算机访问的位置。

5. 完成适合于 tabcmd 计算机操作系统的安装步骤：

   • Windows

     默认情况下，tabcmd 安装到 C:\Program Files\Tableau\Tableau Server\<version>\extras\Command Line Utility。您可以在安装过程中更改此项，并建议将 tabcmd 安装到 C:\ 驱动器 (C:\tabcmd) 根目录处名为 tabcmd 的文件夹中。这可以使查找和运行更加容易，并且如果将 tabcmd 目录添加到 Windows PATH，则它适应 Windows 操作系统的一些限制。

     注意 tabcmd 安装程序不会向 Windows PATH 变量添加 tabcmd 目录。您可以手动添加它，也可以在每次调用 tabcmd 时包含其完整路径。

     您可以通过两种方式在 Windows 上安装 tabcmd：

     • 双击安装程序，按照 UI 中的步骤进行操作：

       1. 接受许可协议。

       2. 如果要安装到非默认位置，请单击“自定义”，并键入或浏览到要将 tabcmd 安装到的位置。

       3. 单击“安装”。

          如果 Windows Defender 防火墙或用户帐户控制提示，请单击“允许访问”。

     • 从命令提示符中运行安装程序：

       1. 在 tabcmd 计算机上以管理员身份打开命令提示符。

       2. 导航到在其中复制了 tabcmd 安装程序的目录。

       3. 安装 tabcmd：

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1

          安装到非默认位置：

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="<path\to\install\directory>"

          例如：

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="C:\tabcmd"

          有关可用于 tabcmd 安装程序的命令行选项的完整列表，请使用 a /? 运行安装程序。有关 tabcmd 安装程序命令行选项的详细信息，请参见tabcmd 的安装开关和属性 (Windows)。

     Tabcmd 安装程序会在 C:\Users\<user>\AppData\Local\Temp 中创建日志，如果安装 tabcmd 时出现问题，您可以使用这些日志。日志使用命名约定 Tableau_Server_Command_Line_Utility_(<version_code>)_##############.log。

   • Linux

     注意：若要在 Linux 计算机上运行 tabcmd，您必须安装 Java 11。在类似 RHEL 的系统上，Java 11 将在您安装 tabcmd 时作为依赖项安装。在 Ubuntu 系统上，如果 Java 11 尚未安装，则需要单独安装。
     
     自 2022 年 7 月起，不再支持 Debian 发行版。有关详细信息，请参见此 Tableau 社区(链接在新窗口中打开)。

     1. 以具有 sudo 访问权限的用户身份登录到 tabcmd 计算机。

     2. 导航到您将所下载的 .rpm 或 .deb 软件包复制到的目录。

        • 在类似于 RHEL 的分发（包括 CentOS）上，运行以下命令：

          sudo yum install tableau-tabcmd-<version>.noarch.rpm

        • 在 Ubuntu 上，运行以下命令：

          sudo apt-get install ./tableau-tabcmd-<version>_all.deb

   若要从 Linux 计算机中卸载 tabcmd，请参见适用于正在运行的 Linux 版本的文档。

6. （可选）将安装 tabcmd 的完全限定位置添加到系统路径中，以允许您运行 tabcmd 命令，而无需更改到该位置，或为每个命令指定位置。执行此操作的步骤取决于操作系统的类型和版本。有关详细信息，请参见 PATH（变量）。

如何使用 tabcmd

使用 tabcmd 的基本步骤如下：

1. 以管理员身份打开命令提示符。

   注意：在 Windows 上，请勿使用 PowerShell 运行 tabcmd 命令。使用 PowerShell 可能会导致意外行为。

2. 在 Windows 计算机上，如果在不是初始节点的计算机上安装了 tabcmd，请切换到安装了 tabcmd 的目录。

   在 Linux 计算机上，您无需切换到安装目录。

3. 运行 tabcmd 命令。

在使用 tabcmd 时，您必须建立经过身份验证的服务器会话。会话会识别服务器或 Tableau Cloud 站点以及运行该会话的用户。您可以先启动会话，然后指定命令，或者在启动会话的同时执行命令。

重要信息：如果您要使用 tabcmd 执行多项任务，则必须依次（连续）运行任务，而非同时（并行）运行。

命令（例如 login）和选项（例如 -s、-u 等）不区分大小写，但您提供的值（例如 User@Example.com）区分大小写。

示例

选项 -s、-t、-u 和 -p 是 tabcmd 的全局变量，可与任何命令一起使用。

有关详细信息，请参见 tabcmd 命令。