更改 Bridge 客户端设置
站点管理员可以配置若干 Bridge 客户端设置来更改客户端的运行方式。在某些情况下,如果数据源所有者维护自己的客户端以运行 Bridge(旧版)计划,则其可能负责执行本主题中描述的某些任务。
以 Windows 服务形式运行 Bridge
为了将客户端包含在池中,客户端应以 Windows 服务形式运行(“服务”模式)。默认情况下,客户端设置为以 Windows 服务形式运行,以便它可以在后台对实时查询和刷新进行负载平衡,而无需专门的用户登录到计算机。客户端要以 Windows 服务形式运行,运行客户端的 Windows 用户帐户必须是计算机上“本地管理员”组的成员。
注意:如果您是数据源所有者并自行管理客户端,则您的客户端将不会包含在池中。但是,如果您希望即使在未登录到计算机的情况下 Bridge(旧版)计划也在后台运行,则客户端必须以 Windows 服务形式运行(“服务”模式)。
打开 Windows 系统托盘,然后单击 Tableau Bridge 图标以打开客户端。
从“模式”下拉菜单中,选择“服务”。将显示登录窗口。
输入您的本地管理员凭据。
在您的 Windows 服务列表中,Bridge 显示为“Tableau Bridge 服务”。您可以在 Windows 服务控制台中或在任务管理器中的“服务”选项卡上看到此项。
停止以 Windows 服务形式运行 Bridge
若要阻止客户端以服务形式运行,请更改其模式。
打开 Windows 系统托盘,然后单击 Tableau Bridge 图标以打开客户端。
从“模式”下拉菜单中,选择“应用程序”。
当客户端在“应用程序”模式下运行时,只有当用户在客户端从中运行的计算机上登录到 Windows 用户帐户时,实时查询和计划刷新才能运行。
切换与客户端关联的站点
如果您希望使用客户端使发布到其他 Tableau Cloud 站点的内容保持最新,则可以取消链接现有客户端,并从客户端中向新站点进行身份验证。
- 打开 Windows 系统托盘,然后单击 Tableau Bridge 图标以打开客户端。
从下拉菜单中,选择“取消链接”。
“取消链接”会从使用 Bridge(旧版)计划、计划和连接信息的客户端中移除数据源列表。
打开 Windows 系统托盘,然后单击 Tableau Bridge 图标以打开客户端。
出现提示时,使用站点管理员凭据登录到新站点。
执行以下一项或两项操作来配置客户端:
如果此客户端刷新与特定客户端关联的数据源,请要求数据源所有者重新配置其数据源并刷新计划。
如果希望此客户端促进实时连接或使用 Online 计划的数据提取连接,请确保新客户端是池的一部分。有关详细信息,请参见配置 Bridge 客户端池
取消链接客户端时,可能还需要为客户端刷新的数据源移除 Bridge(旧版)计划。其他数据源仍然有由池中的其他注册客户端执行的数据新鲜度任务。
有关详细信息,请参见退出和取消链接的影响。
Bridge 客户端设置
配置文件的默认位置为 C:\用户\jsmith\文档\我的 Tableau Bridge 存储库\Configuration\TabBridgeClientConfiguration.txt。
配置 | 配置选项 | 是否可配置? | 描述 |
serviceConnectionSettings | serviceUrl | 否 | Tableau 站点 URL。 |
connection | connectTimeout | 是 | Bridge 客户端在尝试连接到 Tableau Cloud 时的等待时间。 默认值:1 分钟 |
operationTimeout | 是 | 成功连接到 Tableau Cloud 后每个服务器(例如 VizPortal)API 调用的 Bridge 客户端等待时间。 默认值:15 分钟 | |
maxAttemptsToRedirectHttpRequests | 是 | 对服务器的 API 调用可以从 POD 重定向到 POD。此数字指定每次服务器 API 调用的最大重定向次数。 默认值:20 | |
connectionPool | Size | 是 | 适用于 Online 计划。 登录时生成的刷新令牌数。需要与 Tableau Cloud 连接时,Bridge 客户端使用刷新令牌。刷新作业是同时处理的,每个作业都需要一个令牌。 默认值:10 最小值:1 最大值:100。 更改此值需要取消链接客户端。 |
dataSourceRefreshSettings | shutdownTimeoutInSeconds | 不可用 | 过时。不支持。 |
downloadDataSourcesInterval | 是 | 临时下载分配给旧版计划客户端的实时数据源和数据提取数据源的名称的时间间隔。 默认值:30 分钟。 | |
checkRefreshDataSourcesInterval
| 是 | Bridge 客户端检查分配给客户端的数据源以确定旧版计划是否需要刷新的时间间隔。 默认值:5 秒 | |
extractRefreshTimeout | 是 | 强制实施客户端执行的刷新的时间限制。超时限制是单一数据提取在被客户端取消之前完成一次刷新允许的最长时间。如果因为达到超时限制而取消了数据提取刷新,您将在客户端中看到一条消息,并且系统会向数据源所有者发送电子邮件通知。 默认值:24 小时 对于虚拟连接,默认的数据提取刷新超时限制为 2 小时,由 Tableau Cloud 控制。时间限制不能通过 Bridge 客户端控制。 | |
maxRemoteJobConcurrency | 是 | 适用于 Online 计划。 客户端允许的最大远程刷新作业数。此配置的值必须等于或小于 默认值:10 最小值:1 最大值: | |
JSONLogForExtractRefresh | 是 | 设置为 true 时,客户端会生成一个 JSON 格式的附加日志文件。该日志捕获数据提取刷新的指标,包括旧版刷新和远程刷新,每个数据提取一行。 JSON 日志文件的格式是 Tableau Desktop 可读的,并可用作创建实时可视化项的数据源。有关详细信息,请参见 JSON 文件。 日志文件的示例为:
更改此配置选项的值需要重新启动 Bridge 客户端。
默认值:false | |
dataSources | 否 | 适用于旧版计划刷新作业。用户不可编辑。 为基于文件的数据源提供映射的本地文件位置列表。 | |
loggerSettings | maxLogFileSizeInMB | 是 | 日志文件的最大大小(以 MB 为单位)。当日志文件超出大小限制时,将会创建新日志文件。 默认值:25 MB。 |
maxBackupLogFileCount | 是 | 允许的最大 Bridge 日志文件数。当日志文件数量超过限制时,最旧的日志文件将被删除。 默认值为 40。 | |
remoteRequestLogFileLifeSpan | 是 | 对于发送到客户端的每个 Bridge 刷新作业,都会创建一组新的日志文件:tabbridgeclijob_<process_id ,如果数据源是基于 JDBC 的: fjprotocolserver_<process_id>, and stdout_jprotocolserver_<process_id> 。默认情况下,如果日志文件数量超过
默认值:8 小时 | |
dataSyncRestartInterval | 不可用 | 过时。不支持。 | |
internetConnectionMonitorInterval | 是 | Bridge ping 互联网以确定是否存在有效连接的时间间隔。 默认值:30 秒 | |
secureStorageMonitorInterval | 不可用 | 过时。不支持。 | |
cleanUpTempDirOnStartUp | 是 | 确定是否在 Bridge 客户端启动时移除临时文件。 默认值:true | |
JSONLogForLiveQuery | 是 | 设置为 true 时,客户端会生成一个 JSON 格式的附加日志文件。日志捕获实时查询请求的指标,每个数据提取一行。 JSON 日志文件的格式是 Tableau Desktop 可读的,并可用作创建实时可视化项的数据源。有关详细信息,请参见 JSON 文件。 日志文件的示例为:
更改此配置选项的值需要重新启动 Bridge 客户端。
默认值:true |
配置刷新的超时限制
为了数据提取或刷新的滥用,您可以为客户端执行的刷新强制实施一个时间限制(也称为超时限制)。超时限制是单一数据提取在被客户端取消之前完成一次刷新允许的最长时间。
注意:对于虚拟连接的数据提取,默认的数据提取刷新超时限制为 2 小时,并且不能通过 Bridge 客户端控制。或者,您可以修改虚拟连接,在默认的 2 小时期限内进行刷新,或者切换到已发布的数据源。
默认情况下,客户端的超时限制设置为 24 小时。您可以通过 Bridge 配置文件更改客户端的超时限制。如果因为达到超时限制而取消了数据提取刷新,您将在客户端中看到一条消息,并且系统会向数据源所有者发送电子邮件通知。
必须重新启动客户端以使对配置文件所做的任何更改生效。
在安装了客户端的计算机上,转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。
打开 TabBridgeClientConfiguration.txt 文件。
在 extractRefreshTimeout 旁边,更改完成一次刷新任务所允许的时间。
注意:如果在配置文件中未看到参数,您可以添加 "extractRefreshTimeout" ,并将所需的刷新时间添加到 dataSourceRefreshSettings 设置中。
保存并关闭该文件。
退出并重新启动客户端以使更改生效。您重新启动客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。
对于应用程序模式:从客户端菜单中选择“退出”。
对于服务模式:从“模式”下拉菜单中选择“应用程序”;从客户端菜单中选择“退出”。
管理 Bridge 日志文件
客户端在其正常操作过程中会创建活动的日志。您可以使用这些日志来监视刷新、对 Bridge 问题进行故障排除,或者在 Tableau 支持部门向您请求日志以帮助解决问题时使用。
您可以管理 Bridge 日志文件的大小或增加日志文件在 TabBridgeClientConfiguration.txt 文件中删除之前的保留时间。
注意:名为 tabprotosrv® 的日志文件与其他 Bridge 日志文件不同。最大大小为 1 MB,允许的日志文件的最大数量为 8192。这些值也是不可配置的。
在安装了客户端的计算机上,转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。
打开 TabBridgeClientConfiguration.txt 文件。
在 loggerSettings 旁边,您可以更改以下参数的值:
“maxLogFileSizeInMB”:25
“maxBackupLogFileCount”:40
“remoteRequestLogFileLifeSpan”:“08:00:00”
保存并关闭该文件。
退出然后重新启动客户端以使更改生效。您重新启动客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。
对于应用程序模式:从客户端菜单中选择“退出”。
对于服务模式:从“模式”下拉菜单中选择“应用程序”;从客户端菜单中选择“退出”。
管理 Bridge 池的大小
默认情况下,池中的每个客户端一次最多可对 10 个刷新作业进行负载平衡处理。如果在给定时间运行的刷新作业数超过客户端池的容量,或者您有硬件资源来支持它,请考虑增加每个客户端的容量。
您可以在 TabBridgeClientConfiguration.txt 文件中管理客户端的池化容量。
更改 ConnectionPool 配置
重要信息:下面描述的过程需要取消客户端链接。取消链接将移除站点和客户端之间的关联。这意味着,对于使用 Bridge(旧版)计划刷新的数据源,取消客户端链接将移除与这些数据源的关联、其计划和来自客户端的任何连接信息。在修改 Bridge 池大小的过程中,我们建议您单击 Windows 系统托盘中的 Bridge 图标,并记下列出的数据源(步骤 5),以帮助重新计划过程(步骤 10)。
在安装了客户端的计算机上,转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。
Configuration 文件夹的默认位置为 C:\Users\jsmith\Documents\我的 Tableau Bridge 存储库\Configuration。
打开 TabBridgeClientConfiguration.txt 文件。
编辑
ConnectionPool
旁边的值。保存并关闭该文件。
- (可选)单击 Windows 系统托盘中的 Bridge 图标,并记下列出的数据源以及已为这些数据源配置的刷新计划。
右键单击 Windows 系统托盘中的 Bridge 图标,然后选择“取消链接”。
有关“取消链接”选项的详细信息,请参见退出和取消链接的影响。
退出客户端以使更改生效。您退出客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。
对于应用程序模式:从客户端菜单中选择“退出”。
对于服务模式:从客户端菜单中选择“退出”。在对话框中,选中“退出客户端并停止活动”复选框,然后单击“关闭”。
再次启动 Bridge。
出现提示时,使用站点管理员凭据登录 Tableau Cloud。
- (可选)如果对使用 Bridge(旧版)计划的数据源执行步骤 5,请按照添加新的或更新现有 Bridge(旧版)计划中所述的过程重新计划刷新,并高效地将数据源与客户端重新关联。
更改 maxRemoteJobConcurrency 配置
在安装了客户端的计算机上,转到“我的 Tableau Bridge 存储库”中的 Configuration 文件夹。
打开 TabBridgeClientConfiguration.txt 文件。
编辑
maxRemoteJobConcurrency
旁边的值。保存并关闭该文件。
退出客户端以使更改生效。您退出客户端的方式取决于客户端是在应用程序模式还是服务模式下运行。
对于应用程序模式:从客户端菜单中选择“退出”。
对于服务模式:从客户端菜单中选择“退出”。在对话框中,选中“退出客户端并停止活动”复选框,然后单击“关闭”。
再次启动 Bridge。
出现提示时,使用站点管理员凭据登录 Tableau Cloud。
- (可选)如果对使用 Bridge(旧版)计划的数据源执行步骤 5,请按照添加新的或更新现有 Bridge(旧版)计划中所述的过程重新计划刷新,并高效地将数据源与客户端重新关联。