---
schema_version: "1"
id: 9a7707ae7932dfc61383d70907a5b6ec36668527732207454b8531c2714b63f7
title: 安装 Windows 客户端
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/online/to_bridge_window_install.md
canonical_url: https://help.tableau.com/v0.0/online/zh-cn/to_bridge_window_install.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 1cba251dbd40130b328b3630fed7ef6c146b1eefeb2f438142f90bd176bad94e
description: Install and upgrade the Tableau Bridge Windows client.
---
[跳转到主要内容](#main-content)

# 安装 Windows 客户端

对于 Windows 安装，Tableau 建议将 Bridge 客户端安装在防火墙后面的专用计算机上，这样它就不会与其他应用程序的资源竞争。一台计算机上只能安装一个客户端。

### Bridge 客户端要求

以下是 Bridge 客户端的管理和访问要求。

- 需要 Bridge 客户端 UI 来以交互方式登录到 Tableau Cloud。
- 启动驱动器上的_用户配置文件_，用于存储`My Tableau Bridge Repository.`的内容
- 登录用户必须是或等同于计算机的本地管理员才能在服务模式下运行 Bridge 客户端。
- 访问特定于当前登录用户的操作系统库来存储：
    - 特定于 Windows 会话的当前登录用户的在线服务器登录令牌。
    - 远程数据提取请求的数据连接凭据（简单登录信息）。

### 系统建议

Bridge 可用于 Windows 操作系统。您也可以将客户端安装在虚拟机上。有关受支持的 Windows 版本以及其他建议的详细信息，请查看[计划 Bridge 部署](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm)。[计划 Bridge 部署](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm)

## 安装 Bridge

按照下面的过程安装 Windows Bridge 客户端。无需 Tableau 产品密钥也可安装或使用客户端。

1. 从 Tableau 网站上的[下载](https://www.tableau.com/zh-cn/support/releases/bridge)页面下载安装程序。我们建议下载页面上列出的最新版本，以利用最新的安全性和功能更新。
2. 运行安装程序。您可以使用共享的 Windows 服务帐户安装客户端。
    
    用于运行客户端的帐户是配置时登录到 Windows 的帐户。
    
    如果客户端设置有单独的本地用户帐户，则在不重新安装 Bridge 的情况下无法将该帐户更改为共享服务帐户。若要更改帐户，请以当前用户身份卸载 Bridge，登录共享服务帐户，然后重新安装并配置 Bridge。
    
    对于服务模式，Windows 用户帐户必须是计算机上的“本地管理员”组的成员。此外，若要刷新基于文件的数据源，帐户必须对托管文件数据的网络共享驱动器具有域访问权限。
3. 出现提示时，接受许可协议以继续。
4. （可选）通过单击“自定义”来自定义安装。您可以更改以下任何选项：
    
    - **安装位置：**您可以指定其他位置来安装客户端。除非 Windows 管理员已显式更改用户的默认配置文件设置，否则 TEMP 目录和用户配置文件将驻留在系统驱动器（例如 C:）上，即使 Bridge 客户端安装在单独的驱动器上（例如D:）。这是进行硬盘容量和性能规划的重要考虑因素。有关详细信息，请参见[Windows 的磁盘空间规划](https://help.tableau.com/v0.0/online/zh-cn/to_bridge_scale.htm#disk-windows)。
    - **创建桌面快捷方式：**如果不想为 Bridge 自动创建桌面快捷方式，请清除该复选框。
    - **创建开始菜单快捷方式：**如果不想向开始菜单中自动添加 Bridge 快捷方式，请清除该复选框。
    - **启用错误报告：**如果 Bridge 出现问题并意外关闭，将会生成崩溃转储文件和日志，并发送给 Tableau。若要关闭此选项，请在安装过程中清除此复选框。也可以在安装之后在客户端中禁用此选项（或重新启用）。有关详细信息，请参见[错误报告](#error_reports)。
5. 单击“安装”开始客户端安装。

安装客户端之后，可通过以下两种方式启动客户端：双击桌面上的 Bridge 快捷方式，或者从 Tableau Desktop 中启动（如果 Tableau Desktop 与 Bridge 安装在同一台计算机上）。

### 关于“我的 Tableau Bridge 存储库”

在 Bridge 安装过程中，会在安装了客户端的计算机上创建一个名为“**我的 Tableau Bridge 存储库**”的文件夹。此存储库文件夹包含重要的子文件夹，例如 **Logs** 和 **Configuration**，Bridge 需要这些文件夹才能正常操作。

将在“文档”文件夹下创建存储库文件夹：_\\Users\\<user>\\Documents\\My Tableau Bridge Repository_。

**重要信息：**我们强烈建议您不要更改 Bridge 用作其存储库的文件夹。

## 升级 Bridge

与 Bridge 的最新版本保持同步可确保您可以利用 Bridge 客户端的每个新版本附带的最新功能和修复。

### 并行升级（推荐）

为了最大限度地减少停机时间，我们建议运行并行升级过程。在这种情况下，您将新的 Tableau Bridge 客户端安装在与现有 Bridge 客户端运行位置不同的硬件上。运行并行升级过程可以确保稳定性，如果升级过程中出现任何问题，可以立即恢复到已知的良好状态。

若要运行 Bridge 客户端的并行升级，请按照以下过程操作。

1. 登录到安装了现有 Bridge 客户端的计算机。
2. 如果在“服务”模式下运行客户端，请在客户端左上角“模式”的旁边选择“**应用程序**”。更改到“应用程序”模式可确保 Tableau Bridge 服务在升级之前完全停止。选择“设置”\>“退出”。
3. 按照上一节[安装 Bridge](#install)所述添加新计算机并安装新的 Tableau Bridge 客户端。
4. 将新的 Bridge 客户端添加到相关池。请参见[配置池](https://help.tableau.com/v0.0/online/zh-cn/to_enable_bridge_live_connections.htm)。
5. 在继续下一步之前，请监控 Bridge 作业的运行状况以验证稳定性。
6. 从池中移除之前的 Bridge 客户端。打开池，找到要移除的客户端计算机，然后单击**“删除”**。
7. 等待 Bridge 客户端上的数据提取刷新超时过程完成。默认超时为 24 小时。有关详细信息，请参见[dataSourceRefreshSettings](https://help.tableau.com/v0.0/online/zh-cn/to_sync_change_computer_site.htm#dataSourceRefreshSettings)。
8. 刷新超时期限过后，您可以移除运行 Bridge 先前版本的硬件。

安装完成后，客户端将正常启动。如果升级过程之前客户端在“服务”模式下运行，请切换回“服务”模式。

### 非并行升级

如果无法运行两台并行计算机，请按照以下步骤在同一台计算机上升级 Bridge 客户端。请注意，在步骤 #2 和步骤 #3 之间，作业将无法运行。在移除旧版本之前，您也无法监控 Bridge 作业的稳定性。

1. 登录到安装了现有 Bridge 客户端的计算机。
2. 如果在“服务”模式下运行客户端，请在客户端左上角“模式”的旁边选择“**应用程序**”。更改到“应用程序”模式可确保 Tableau Bridge 服务在升级之前完全停止。选择“设置”\>“退出”。
3. 按照上一节[安装 Bridge](#install)中所述的步骤安装新的 Tableau Bridge 客户端， 。

安装完成后，客户端将正常启动。如果升级过程之前客户端在“服务”模式下运行，请切换回“服务”模式。

## 错误报告

您可通过向 Tableau 自动发送错误报告来帮助改进 Bridge。错误报告包含在 Bridge 客户端不得不意外关闭（崩溃）时发送给 Tableau 的崩溃转储文件。Tableau 使用这些文件来确定和解决导致客户端意外关闭的问题。

**重要信息：**如果您的数据须遵守任何隐私法规，请关闭此选项。

### 错误报告的内容

加密包由以下文件组成：崩溃和核心转储文件，以及与崩溃相关的清单文件。

这些文件可能包含包括以下内容的数据：

- 特定于计算机的信息。例如：硬件、操作系统、域，等等。
- 发生崩溃时内存内容的快照。例如：哪些数据源有刷新的数据提取、哪些数据源有实时查询，等等。
- 发生崩溃时 Bridge 正在处理的信息，包括可能用于纠正错误的可识别客户的信息。例如：谁正在将 Bridge 用于哪个站点，用户所登录到的客户端的名称，等等。

有关 Tableau 如何处理敏感信息的详情，请参见 Tableau 网站上的 [Tableau 隐私策略](https://www.tableau.com/zh-cn/privacy)。

### 配置自动错误报告

您可以将 Bridge 配置为在以下两个位置之一自动发送错误报告：在客户端安装过程中发送，或者安装之后直接在客户端中发送。

#### 在客户端安装过程中启用自动错误报告选项

在安装过程中，用于从客户端中自动发送错误报告的选项默认情况下已选定。但是，您可以移除选择。

![Tableau Bridge 安装屏幕，其中包含创建桌面快捷方式和启用错误报告的选项。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_installer_error_reporting_WOdriver.png)

#### 在客户端中禁用自动错误报告选项

如果在安装过程中决定使用默认设置，而稍后又决定不想允许自动发送错误报告，您可以通过客户端菜单修改选项。

![Tableau Bridge 设置菜单，提供发送错误报告的选项。](/tableau/next/zh-cn/online/zh-cn/Img/bridge_send_error_reports.png)

## 通过命令行安装 Bridge

如果您是计算机上的本地管理员，则可以通过命令行安装 Bridge 客户端。

### 一般命令行语法

用于从命令行中运行 Bridge 安装程序的语法如下：

`tableauBridge<installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2`

有关语法的一些注意事项：

- `tableau<installer_name>.exe` 文件是您所安装的产品和版本的客户端安装程序。
- 这些选项指定安装过程应如何运行。例如，是否应在安装时显示输出，以及是否应创建日志文件。
- 属性设置指定安装程序在安装过程中应进行的配置设置。

#### 示例安装程序命令

以下示例显示具有一些选项和属性设置的安装程序命令：

`TableauBridge-20232.23.0611.2007-x64.exe/quiet /passive ACCEPTEULA=1`

您必须从 .exe 文件所在的目录运行命令，或指定计算机上 .exe 文件位置的完整路径。不要从网络上的共享目录中运行安装程序。而是要将 .exe 文件下载到您要安装客户端的计算机上的某个目录。

### 安装程序选项和属性

您可以为安装程序在命令行中指定一个或多个选项。

#### 安装程序选项

有关选项的一些注意事项： 

- 每个选项都以斜杠 (/) 为前缀。
- 选项必须放在属性前面。

<table class="simple-table"><colgroup><col style="width: 25%;"><col></colgroup><tbody><tr><th>选项</th><th>描述</th></tr><tr><td><code>quiet</code></td><td>运行安装程序时不会显示消息（状态或安装进度），也无需用户交互。客户端在安装完成后不会启动。</td></tr><tr><td><code>passive</code></td><td>运行安装程序并显示对话框以及安装状态。不提示用户输入内容。客户端在安装完成后启动。</td></tr><tr><td><code>norestart</code></td><td>禁止任何尝试重新启动的操作。默认情况下，安装程序将在重新启动之前提示您，除非您在无提示模式下运行安装程序。</td></tr><tr><td><code>log "<em>logfile.txt</em>"</code></td><td>将安装信息记录到指定的路径和文件。指定路径和文件名，例如 <code>/log "c:\logs\logfile.txt"</code>。默认日志文件为系统 <code>%TEMP%</code> 目录。</td></tr><tr><td><code>repair</code></td><td>运行安装程序以修复 Bridge 的现有安装。</td></tr><tr><td><code>h</code></td><td>Help — 列出安装程序的选项和属性。</td></tr></tbody></table>

#### 安装程序属性

您还可以为安装程序在命令行中包括一个或多个属性。

有关属性的一些注意事项：

- 所有这些属性均可用于客户端的初始安装。它们不能用于在初始安装后更新任何设置。
- 属性名称区分大小写。
- 等号的两边没有空格。
- 各个属性集用空格分隔。
- 属性必须放在选项后面。

<table class="simple-table" style="width: 100%;"><colgroup><col title="1" style="width: 22%;"><col title="2" style="width: 40%;"><col></colgroup><tbody><tr><th>属性</th><th>描述</th><th>值</th></tr><tr><td><code>ACCEPTEULA</code></td><td>接受最终用户许可协议 (EULA)。如果未将此选项设置为 <code>1</code>，则无法使用无提示模式安装 Bridge。</td><td>1 = 接受 <br>0 = 不接受（默认值）</td></tr><tr><td><code>CRASHDUMP</code></td><td>您可以将此选项设置为“1”，通过在客户端崩溃时自动向 Tableau 发送错误报告来帮助改进 Bridge。有关详细信息，请参见<a href="#error_reports" class="xref">错误报告</a>。</td><td>1 = 是（默认值）<br>0 = 否</td></tr><tr><td><code>DESKTOPSHORTCUT</code></td><td>创建桌面快捷方式。</td><td>1 = 是（默认值） <br>0 = 否</td></tr><tr><td><code>DRIVERDIR</code></td><td>为数据库驱动程序指定（除默认目录之外的）安装目录。此选项会创建该目录并在 HKEY_LOCAL_MACHINE\ 注册表中创建一个条目。驱动程序的默认位置为 C:\Program Files\Tableau\Drivers。</td><td>诸如 <code>D:\Drivers</code> 之类的路径</td></tr><tr><td><code>INSTALLDIR</code></td><td><p>指定除默认目录之外的安装目录。</p><p>如果为安装位置指定自定义目录，并打算将未来的版本安装到此相同位置，您必须指定要安装到其中的版本特定子文件夹。否则，您必须先卸载以前的版本。</p><p>不支持将多个版本并排安装在同一子目录中。</p></td><td>诸如 <code>D:\Software\Tableau Bridge</code> 等路径。</td></tr><tr><td><code>SKIPAPPLICATIONLAUNCH</code></td><td>您可以将此选项设置为“1”，防止新应用程序在安装过程完成时自动打开。此选项适用于手动安装。此选项不适用于无提示安装，因为在使用该选项时 Tableau Bridge 不会自动打开。</td><td>1 = 是 <br>0 = 否（默认值）</td></tr><tr><td><code>STARTMENUSHORTCUT</code></td><td>在 Windows 的“开始”菜单上创建 Tableau Bridge 条目。</td><td>1 = 是（默认值） <br>0 = 否</td></tr></tbody></table>

## 卸载 Bridge

尽管在安装较新版本时不必卸载以前版本的 Bridge 客户端，但如果计算机上不再需要 Bridge 2018.2 及更高版本，您可以将其卸载。

卸载客户端的主要方法是通过 Windows 控制面板。

或者，您可以使用以下过程通过命令行卸载 Bridge。

1. 以管理员身份打开命令提示符。
2. 在 .exe 的安装位置中，运行以下命令：
    
    `tableau<installer_name>.exe /uninstall /quiet`