更改 Bridge 客户端设置

站点管理员可以配置若干 Bridge 客户端设置来更改客户端的运行方式。在某些情况下，如果数据源所有者维护自己的客户端以运行 Bridge（旧版）计划，则其可能负责执行本主题中描述的某些任务。

以 Windows 服务形式运行 Bridge

为了将客户端包含在池中，客户端应以 Windows 服务形式运行（“服务”模式）。默认情况下，客户端设置为以 Windows 服务形式运行，以便它可以在后台对实时查询和刷新进行负载平衡，而无需专门的用户登录到计算机。客户端要以 Windows 服务形式运行，运行客户端的 Windows 用户帐户必须是计算机上“本地管理员”组的成员。

注意：如果您是数据源所有者并自行管理客户端，则您的客户端将不会包含在池中。但是，如果您希望即使在未登录到计算机的情况下 Bridge（旧版）计划也在后台运行，则客户端必须以 Windows 服务形式运行（“服务”模式）。

1. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。

2. 从“模式”下拉菜单中，选择“服务”。将显示登录窗口。

   

3. 输入您的本地管理员凭据。

   在您的 Windows 服务列表中，Bridge 显示为“Tableau Bridge 服务”。您可以在 Windows 服务控制台中或在任务管理器中的“服务”选项卡上看到此项。

停止以 Windows 服务形式运行 Bridge

若要阻止客户端以服务形式运行，请更改其模式。

1. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。

2. 从“模式”下拉菜单中，选择“应用程序”。

   

当客户端在“应用程序”模式下运行时，只有当用户在客户端从中运行的计算机上登录到 Windows 用户帐户时，实时查询和计划刷新才能运行。

切换与客户端关联的站点

如果您希望使用客户端使发布到其他 Tableau Online 站点的数据源保持最新，则可以取消链接现有客户端，并从客户端中向新站点进行身份验证。

1. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。

2. 从下拉菜单中，选择“取消链接”。

   
   

   “取消链接”会从客户端中删除数据源、计划和连接信息的列表。

3. 打开 Windows 系统托盘，然后单击 Tableau Bridge 图标以打开客户端。

4. 出现提示时，使用站点管理员凭据登录到新站点。

5. 执行以下一项或两项操作来配置客户端：

   • 如果此客户端刷新基于文件的数据源，请要求数据源所有者重新配置其数据源并刷新计划。

   • 如果希望此客户端促进实时连接或使用“建议”计划的数据提取连接，请确保新客户端是池的一部分。有关详细信息，请参见配置和管理 Bridge 客户端池

取消链接客户端时，可能还需要为客户端刷新的数据源移除 Bridge（旧版）计划。其他数据源仍然有由池中的其他注册客户端执行的数据新鲜度任务。

有关详细信息，请参见退出和取消链接的影响。

配置刷新的超时限制

为了数据提取或刷新的滥用，您可以为客户端执行的刷新强制实施一个时间限制（也称为超时限制）。超时限制是单一数据提取在被客户端取消之前完成一次刷新允许的最长时间。如果因为达到超时限制而取消了数据提取刷新，您将在客户端中看到一条消息，并且系统会向数据源所有者发送电子邮件通知。

默认情况下，客户端的超时限制设置为 24 小时。您可以通过 Bridge 配置文件更改客户端的超时限制。

注意：必须重新启动客户端以使对配置文件所做的任何更改生效。

1. 在安装了客户端的计算机上，转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。

   Configuration 文件夹的默认位置为 C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration。

2. 打开 TabBridgeClientConfiguration.txt 文件。

3. 在 extractRefreshTimeout 旁边，更改完成一次刷新任务所允许的时间。

   注意：如果在配置文件中未看到参数，您可以像下面的示例中一样，向 dataSourceRefreshSettings 设置中添加 "extractRefreshTimeout" : 08:00:00",。

   

4. 保存并关闭该文件。

5. 退出并重新启动客户端以使更改生效。您重新启动客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。

   • 对于应用程序模式：从客户端菜单中选择“退出”。

   • 对于服务模式：从“模式”下拉菜单中选择“应用程序”；从客户端菜单中选择“退出”。

管理 Bridge 日志文件

客户端在其正常操作过程中会创建活动的日志。在您排查 Bridge 问题时或者 Tableau 支持人员需要使用日志来帮助您解决问题时，您可能需要使用这些日志。

您可以管理 Bridge 日志文件的大小或增加日志文件在 TabBridgeClientConfiguration.txt 文件中删除之前的保留时间。

可配置选项

• maxLogFileSizeInMB：默认情况下，Bridge 日志文件允许的最大大小为 25 MB。当日志文件超出大小限制时，将会创建新日志文件。

• maxBackupLogFileCount：允许的 Bridge 日志文件的最大数量的默认值为 40。当日志文件数量超过限制时，最旧的日志文件将被删除。

• remoteRequestLogFileLifeSpan：对于发送到客户端的每个 Bridge 刷新作业，都会创建一组新的日志文件：tabbridgeclijob_<进程 id>、jprotocolserver_<进程 id> 程 stdout_jprotocolserver_<进程 id>。默认情况下，如果日志文件数量超过 maxBackupLogFileCount，日志文件在删除之前保留在 Logs 文件夹中的最长时间为 8 小时。否则，这些日志文件将无限期保留，而日志文件的数量小于或等于 maxBackupLogFileCount。

  注意：此处 <进程 id> 表示 Windows 进程 ID。

注意：名为 tabprotosrv® 的日志文件与其他 Bridge 日志文件不同。最大大小为 1 MB，允许的日志文件的最大数量为 8192。这些值也是不可配置的。

1. 在安装了客户端的计算机上，转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。

   Configuration 文件夹的默认位置为 C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration。

2. 打开 TabBridgeClientConfiguration.txt 文件。

3. 在 loggerSettings 旁边，您可以更改以下参数的值：

   “maxLogFileSizeInMB”：25

   “maxBackupLogFileCount”：40

   “remoteRequestLogFileLifeSpan”：“08:00:00”

4. 保存并关闭该文件。

5. 退出然后重新启动客户端以使更改生效。您重新启动客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。

   • 对于应用程序模式：从客户端菜单中选择“退出”。

   • 对于服务模式：从“模式”下拉菜单中选择“应用程序”；从客户端菜单中选择“退出”。

   管理 Bridge 池的大小

   默认情况下，池中的每个客户端一次最多可对 10 个刷新作业进行负载平衡处理。如果在给定时间运行的刷新作业数超过客户端池的容量，或者您有硬件资源来支持它，请考虑增加每个客户端的容量。

   您可以在 TabBridgeClientConfiguration.txt 文件中管理客户端的池化容量。

   可配置选项

   • ConnectionPool：这是客户端允许的绝对最大并发刷新作业数。默认值为 10，允许的最小值为 1，允许的最大值为 100。更改此值需要取消链接客户端。

   • maxRemoteJobConcurrency：这是客户端允许的最大并发刷新作业数，可用于调整或解决客户端性能问题，而无需更改 ConnectionPool 中的绝对值。默认值为 10。此值必须等于或小于为 ConnnectionPool 指定的值。更改此值不需要取消链接客户端。

   更改 ConnectionPool

   重要信息：下面描述的过程需要取消客户端链接。取消链接将移除站点和客户端之间的关联。这意味着，对于使用 Bridge（旧版）计划刷新的数据源，取消客户端链接将移除与这些数据源的关联、其计划和来自客户端的任何连接信息。在修改 Bridge 池大小的过程中，我们建议您单击 Windows 系统托盘中的 Bridge 图标，并记下列出的数据源（步骤 5），以帮助重新计划过程（步骤 10）。

   1. 在安装了客户端的计算机上，转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。

      Configuration 文件夹的默认位置为 C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration。

   2. 打开 TabBridgeClientConfiguration.txt 文件。

   3. 编辑 ConnectionPool 旁边的值。

   4. 保存并关闭该文件。

   5. （可选）单击 Windows 系统托盘中的 Bridge 图标，并记下列出的数据源以及已为这些数据源配置的刷新计划。
      

   6. 右键单击 Windows 系统托盘中的 Bridge 图标，然后选择“取消链接”。

      

      有关“取消链接”选项的详细信息，请参见退出和取消链接的影响。

   7. 退出客户端以使更改生效。您退出客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。

      • 对于应用程序模式：从客户端菜单中选择“退出”。

      • 对于服务模式：从客户端菜单中选择“退出”。在对话框中，选中“退出客户端并停止活动”复选框，然后单击“关闭”。

        

   8. 再次启动 Bridge。

   9. 出现提示时，使用站点管理员凭据登录 Tableau Online。

   10. （可选）如果对使用 Bridge（旧版）计划的数据源执行步骤 5，请按照添加新的或更新现有 Bridge（旧版）计划中所述的过程重新计划刷新，并高效地将数据源与客户端重新关联。

更改 maxRemoteJobConcurrency

1. 在安装了客户端的计算机上，转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。

   Configuration 文件夹的默认位置为 C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration。

2. 打开 TabBridgeClientConfiguration.txt 文件。

3. 编辑 maxRemoteJobConcurrency 旁边的值。

4. 保存并关闭该文件。

5. 退出客户端以使更改生效。您退出客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。

   • 对于应用程序模式：从客户端菜单中选择“退出”。

   • 对于服务模式：从客户端菜单中选择“退出”。在对话框中，选中“退出客户端并停止活动”复选框，然后单击“关闭”。

     

6. 再次启动 Bridge。

7. 出现提示时，使用站点管理员凭据登录 Tableau Online。

8. （可选）如果对使用 Bridge（旧版）计划的数据源执行步骤 5，请按照添加新的或更新现有 Bridge（旧版）计划中所述的过程重新计划刷新，并高效地将数据源与客户端重新关联。