--- schema_version: "1" id: e87a40d4a8266c02f302ea1cf52e0f47618170c269ff6a1f8b1f80b2c5a7c3c0 title: 关于 Bridge 客户端 collection: tableau version: current locale: zh-cn portal_url: https://docs.salesforce.com/tableau/current/zh-cn/online/to_bridge_client.md canonical_url: https://help.tableau.com/current/online/zh-cn/to_bridge_client.htm source_site: help.tableau.com content_type: documentation content_hash: 8a545531f7f23c5eb09e4f58047be8adeb10de4db6446ac6893aab39842462ce description: Understand the Tableau Bridge client and its requirements for Windows and Linux. --- [跳转到主要内容](#main-content) # 关于 Bridge 客户端 本主题介绍 Bridge 客户端以及运行和使用该客户端的要求。大多数情况下，站点管理员负责安装和管理客户端。 **注意**：Tableau Cloud 2025.2（2025 年夏季）版本中新增了对 OAuth 连接的一次性刷新令牌（有时称为一次性刷新令牌、滚动刷新令牌或刷新令牌轮换）的支持，并在 Tableau Server 2025.3 版本中添加了支持（如果数据源提供商的 IDP 支持）。这些令牌在 Tableau Bridge 与 Tableau Cloud 的连接上尚不受支持。如果为连接使用外部 OAuth 配置，请参见 GitHub 中的 [OAuth 配置和使用文档](https://tableau.github.io/connector-plugin-sdk/docs/oauth "OAuth 配置文档")了解详细信息。 ## Linux 和 Windows 客户端概述 - Bridge 客户端需要在 Tableau Cloud 和私有网络数据之间启用连接。 - 站点的已连接客户端选项必须为启用状态，以允许 Tableau Bridge 客户端在无人值守的情况下运行，并且如果启用，则支持多重 Tableau 身份验证。 - 客户端会话由刷新令牌管理，刷新令牌是从 Bridge 客户端成功登录 Tableau Cloud 后生成的。如果刷新令牌在 14 天内未使用，则它将过期。刷新令牌过期后，需要重新登录 Tableau Cloud。如果刷新令牌会定期使用，其有效期取决于站点的激活时间。在 2023 年 6 月 (Tableau 2023.2) 或更高版本激活的站点上生成的刷新令牌将在 180 天后过期。所有其他站点上生成的刷新令牌将在一年后过期。 - 对于 Windows，一台计算机上只能安装一个客户端。对于 Linux，群集内的每个容器只能安装一个客户端。 - 必须在运行客户端的计算机上安装相应的数据库驱动程序。 - 对于数据提取连接，从客户端登录到 Tableau Cloud 的用户必须具有“Creator”、“Explorer（可发布）”角色，或两种类型的站点管理员角色之一：“站点管理员 Creator”或“站点管理员 Explorer”。如果用户不是站点管理员，则其必须是内容所有者。 - 对于实时连接，从客户端登录到 Tableau Cloud 的用户必须具有两种类型的站点管理员角色之一：“站点管理员 Creator”或“站点管理员 Explorer”。 - 若要维护实时连接，则_无法_从公共 Internet 访问 Tableau 内容连接到的数据库。 ### 关于 Linux Bridge 客户端 您可以在 Linux 上的容器内部署 Tableau Bridge 客户端。若要在 Linux 上使用 Bridge，您必须创建自定义 Docker 映像，安装 RPM 包，然后从容器映像内部运行 Bridge。请参见[为容器安装 Linux 版 Bridge](https://help.tableau.com/current/online/zh-cn/to_bridge_linux_install.htm)。 ### 关于 Windows Bridge 客户端 当客户端运行时，可从安装客户端的计算机上的 Windows 系统托盘中访问该客户端。 ![与在线数据源的 Tableau Bridge 连接。](/tableau/current/zh-cn/online/zh-cn/Img/bridge_client_overview.png) 客户端由以下几部分组成： 1. **客户端名称**，同时也是安装了客户端的计算机的名称。 2. **连接状态**指明客户端是否已连接到 Tableau Cloud。 3. **站点**：客户端注册到的 Tableau Cloud 站点。 4. **设置菜单**，其中包含用于禁用错误报告和从站点取消链接客户端的选项。 5. **数据源**：默认情况下，此区域显示整个站点中客户端正在对其进行负载平衡（或池化）的实时查询的列表。此列表还可以包含已使用 Bridge（旧版）计划分配给此特定客户端的数据源。 **注意：**此列表不显示使用 Bridge 刷新计划刷新的数据源或虚拟连接。若要查看使用 Bridge 刷新计划刷新的数据源或虚拟连接，请转到“作业”页面，并在“Bridge 刷新”上进行筛选。 6. **池化状态**：这显示数据源是否为客户端池的一部分。 - 实时：实时状态指明数据源具有实时连接，并且是客户端池的一部分。**注意：**具有实时连接的虚拟连接未显示在此列表中。 - 空白：空白状态指明客户端不是池的一部分。这是因为数据源正在使用 Bridge（旧版）计划。 7. **旧版选项**：这些选项在悬停时显示，以编辑或查看连接信息、转到计划，并在悬停时为使用 Bridge （旧版）计划的数据源运行手动刷新。 8. **客户端模式**指明客户端是以 Windows 应用程序形式还是服务形式运行。有关详细信息，请参见下面的部分。 ### Windows 对数据提取连接的要求 - 若要刷新数据提取，客户端可以作为 Windows 服务或应用程序运行。 - 如果将客户端设置为以应用程序形式运行，则仅当计算机开机并且 Windows 用户登录并运行 Bridge 时，它才会完成刷新。 如果计算机已关闭、用户注销 Windows 或者退出客户端，则该客户端上运行的数据源或虚拟连接的更新（通过池或手动方式）将无法到达 Tableau Cloud，并且数据源或虚拟连接不会刷新，直到用户再次登录。在此期间，内容所有者将收到来自 Tableau Cloud 的刷新失败通知电子邮件。有关详细信息，请参见[通过 Bridge 停止使数据保持最新](https://help.tableau.com/current/online/zh-cn/to_sync_signout_unlink.htm)。 - 为了确保基于文件的数据源的刷新在没有任何问题的情况下完成，设置为以服务方式运行的客户端必须引用源文件的完整 UNC 路径，而不是映射的驱动器路径。例如，使用“\\\\filesrv\\Data\\file.csv”而不是“C:\\Data\\file.csv”。 对于设置为以应用程序形式运行的客户端，我们强烈建议客户端也引用完整 UNC 路径。有关详细信息，请参见[更改数据源的文件路径](https://help.tableau.com/current/online/zh-cn/to_sync_client_settings.htm#file-path)。 ### Windows 对实时连接的要求 - 若要运行实时查询，客户端可以作为 Windows 服务或 Windows 应用程序运行。 - 每个 Tableau Cloud 站点都可以有多个维护实时连接的客户端。也可以使用这些客户端来刷新数据提取。 - 如果将客户端设置为以应用程序形式运行，则仅当计算机开机并且 Windows 用户登录并运行 Bridge 时，实时查询才能进行。 如果计算机已关闭、用户注销 Windows 或者退出客户端，则对数据源或虚拟连接的更新将无法到达 Tableau Cloud，并且内容无法保持最新。 ### 应用程序模式与服务模式 客户端可在两种模式之一下操作：应用程序或服务。 客户端可以运行的模式取决于它运行所采用 Windows 用户帐户、客户端注册到的 Tableau Cloud 站点设置以及一般数据新鲜度需求。 - **应用程序：**当客户端设置为在“应用程序”模式下运行时，它将以 Windows _应用程序_形式运行。 在这种模式下，当专门的用户登录到 Windows 时，客户端可方便地对连接到私有网络数据的内容进行实时查询和计划刷新。如果专门的用户退出 Windows，则客户端无法维护实时查询和按计划刷新数据提取。 - **服务：**当客户端设置为在服务模式下运行时，它将以 Windows _服务_形式运行。 在此模式下，即使用户退出 Windows，客户端也会持续运行。Windows 用户帐户必须是“本地管理员”组的成员，才能在服务模式下运行客户端。帐户还必须能够以用户身份登录并缓存凭据。对于对实时查询和计划刷新进行负载平衡的池化客户端，建议使用此模式。服务模式为默认模式。 模式准则
 包含已计划刷新的数据提取连接实时连接
应用程序模式
  • 快速设置并验证客户端是否使内容保持最新。
  • 更大程度地控制客户端何时执行数据新鲜度任务。
  • 不要求用户是计算机上的本地管理员。
  • 要求用户登录到 Windows。
服务模式
  • 设置客户端一次 — 如果计算机必须重新启动，客户端将自动重新连接到 Tableau Cloud。
  • 要求 Windows 用户帐户是计算机上的“本地管理员”组的成员。此外，若要刷新基于文件的数据源，帐户必须对托管文件数据的网络共享驱动器具有域访问权限。
  • 不要求用户登录到 Windows。

推荐用于对刷新进行负载平衡。有关详细信息，请参见配置池。

推荐用于对实时查询进行负载平衡。有关详细信息，请参见配置池。

### Windows 客户端要求 为了运行和使用客户端，必须满足一组特定要求以及数据新鲜度任务独有的一些附加要求。 ### 核心要求 - Microsoft Windows 10 或更高版本，64 位 - Windows Server 2016、Windows Server 2019、Windows Server 2022 **注意**：尚不支持 Windows Server 2025。有关详细信息，请参见产品知识文章 [Tableau Server 与 Windows Server 2025 不兼容](https://help.salesforce.com/s/articleView?id=004811287&type=1)。 - Tableau 建议在防火墙后面的专用计算计算安装 Bridge 客户端。 - 客户端在其上运行的计算机必须位于相同的 Windows 域上，并且可以访问数据源或虚拟连接中指定的基础数据库。 - 计算机和 Windows 用户帐户必须能够访问数据源或虚拟连接中指定的基础数据。 - Tableau Cloud 的_已连接客户端_选项必须保持启用状态，以允许客户端在无人值守的情况下运行，如果启用，则支持多重 Tableau 身份验证。有关已连接客户端选项的详细信息，请参见[Tableau Bridge 的已连接客户端要求](https://help.tableau.com/current/online/zh-cn/to_connected_clients.htm#bridge)。 有关详细信息，请参见[池化容量](https://help.tableau.com/current/online/zh-cn/to_bridge_scale.htm#Pooling)。 ### 针对“服务”模式的额外要求 - 若要在“**服务**”模式下运行客户端，运行 Bridge 的 Windows 用户帐户必须是计算机上的“本地管理员”组的成员。用户不需要登录到 Windows，但计算机必须开机并运行 Windows。 - 在“服务”模式下使用客户端并连接到网络共享驱动器中托管的文件数据时，要求帐户是有网络共享驱动器的域访问权限。 ## 修复在“服务”模式下运行的客户端 有时，某些原因会导致内容连接正常停止工作。发生这种情况时会出现通知，并且通知通常会提供相关信息，引导您找到问题的原因。但是，如果 Tableau Cloud 无法在通知中提供故障排查信息，并且您以服务形式运行 Tableau Bridge，则可以使用“修复”命令来尝试重置连接。 为了帮助在“服务”模式下修复客户端，在 Windows 系统托盘中，右键单击 Bridge 图标并选择“修复”。这将停止并重新启动服务，已足以解决该问题。 ## 临时文件 Bridge 临时文件位于 `C:\Users\\AppData\Local\Temp` 文件夹中。 连接到 Tableau Cloud 时或关闭客户端后，临时文件会定期移除。 - 刷新后，`TEMP_*` 文件会被移除。 - Bridge 客户端关闭后，`hyper_` 文件将被删除。 - 由于系统要求，TableauTemp 文件夹不会被移除。 `cleanUpTempDirOnStartUp` 客户端设置确定是否在 Bridge 客户端启动时移除临时文件。设置为 false 时，不会移除临时文件。