更改 Bridge 客户端设置
站点管理员可以配置若干 Bridge 客户端设置来更改客户端的运行方式。
Windows 客户端
对于 Windows 客户端,配置文件的默认位置为 C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt
。必须重新启动客户端以使对配置文件所做的任何更改生效。
适用于容器的 Linux 版 Bridge
TabBridgeClientConfiguration.txt
文件是在您第一次运行 Bridge 客户端时使用默认配置生成的。
若要更改配置文件,请编辑 TabBridgeClientConfiguration.txt
并 使用更新的文件创建一个新的 Docker 容器。有关如何创建和更新容器的详细信息,请参见容器化应用程序。
Bridge 旧版计划
在某些情况下,如果数据源所有者维护自己的客户端以运行 Bridge 旧版计划,则其可能负责执行本主题中描述的某些任务。
Bridge 客户端设置
serviceConnectionSettings
配置:serviceConnectionSettings
选项:
serviceUrl | Tableau 站点 URL。 不可配置。 |
proxyServer | 代理服务器和端口。 可配置 |
示例
必须重新启动客户端以使对配置文件所做的任何更改生效。
"serviceConnectionSettings" : {
"serviceUrl" : "https://online.tableau.com",
"proxyServer" : {
"serverName" : "http://localhost",
"serverPort" : 8888
}
connection
配置:connection
选项:
connectTimeout | Bridge 客户端在尝试连接到 Tableau Cloud 时的等待时间。 默认值:1 分钟 可配置。 |
operationTimeout | 成功连接到 Tableau Cloud 后每个服务器(例如 VizPortal)API 调用的 Bridge 客户端等待时间。 默认值:15 分钟 可配置。 |
maxAttemptsToRedirectHttpRequests | 对服务器的 API 调用可以从 POD 重定向到 POD。此数字指定每次服务器 API 调用的最大重定向次数。默认值:20 可配置。 |
示例
"connection" : {
"connectTimeout" : "00:01:00",
"operationTimeout" : "00:15:00",
"maxAttemptsToRedirectHttpRequests" : 20
}
connectionPool
配置:connectionPool
选项:
size | 适用于 Bridge 刷新计划。 登录时生成的刷新令牌数。需要与 Tableau Cloud 连接时,Bridge 客户端使用刷新令牌。刷新作业是同时处理的,每个作业都需要一个令牌。 默认值:10 最小值:1 最大值:100。 可配置。 |
示例
默认情况下,池中的每个客户端一次最多可对 10 个刷新作业进行负载平衡处理。如果在给定时间运行的刷新作业数超过客户端池的容量,或者您有硬件资源来支持它,请考虑增加每个客户端的容量。
在 Windows 上,更改 size
值需要取消链接客户端。取消链接将移除站点和客户端之间的关联。这意味着,对于使用 Bridge 旧版计划刷新的数据源,取消客户端链接将移除与这些数据源的关联、其计划和来自客户端的任何连接信息。在修改 Bridge 池大小的过程中,我们建议您单击 Windows 系统托盘中的 Bridge 图标,并记下列出的数据源,以帮助重新计划过程。
"connection" : {
"connectTimeout" : "00:01:00",
"operationTimeout" : "00:15:00",
"maxAttemptsToRedirectHttpRequests" : 20
},
"connectionPool" : {
"size" : 10
}
dataSourceRefreshSettings
配置:dataSourceRefreshSettings
选项:
shutdownTimeoutInSeconds | 不可配置。 |
downloadDataSourcesInterval | 临时下载分配给 Bridge 旧版计划客户端的实时数据源和数据提取数据源的名称的时间间隔。 默认值:30 分钟。 可配置。 |
checkRefreshDataSourcesInterval | Bridge 客户端检查分配给客户端的数据源以确定 Bridge 旧版计划是否需要刷新的时间间隔。 默认值:5 秒 可配置。 |
extractRefreshTimeout | 强制实施客户端执行的刷新的时间限制。超时限制是单一数据提取在被客户端取消之前完成一次刷新允许的最长时间。如果因为达到超时限制而取消了数据提取刷新,您将在客户端中看到一条消息,并且系统会向数据源所有者发送电子邮件通知。 默认值:24 小时 对于虚拟连接,默认的数据提取刷新超时限制为 2 小时,由 Tableau Cloud 控制。时间限制不能通过 Bridge 客户端控制。 可配置。 |
maxRemoteJobConcurrency | 适用于 Bridge 刷新计划。客户端允许的最大远程刷新作业数。此配置的值必须等于或小于 connectionPool。将最大值调整为您的计算机的能力,例如 CPU 和 RAM。需要重新启动客户端。 默认值:10 最小值:1 最大值: 可配置。 |
JSONLogForExtractRefresh | 设置为 true 时,客户端会生成一个 JSON 格式的附加日志文件。该日志捕获数据提取刷新的指标,包括 Bridge 旧版刷新和远程刷新,每个数据提取一行。 JSON 日志文件的格式是 Tableau Desktop 可读的,并可用作创建实时可视化项的数据源。有关详细信息,请参见 JSON 文件。 日志文件的示例为:
默认值:false 可配置。 |
dataSources | 适用于 Bridge 旧版计划刷新作业。用户不可编辑。 为基于文件的数据源提供映射的本地文件位置列表。 不可配置 |
示例
为了数据提取或刷新的滥用,您可以使用 extractRefreshTimeout
,为客户端执行的刷新强制实施一个时间限制(也称为超时限制)。超时限制是单一数据提取在被客户端取消之前完成一次刷新允许的最长时间。
注意:对于虚拟连接的数据提取,extractRefreshTimeout
的默认值为 2 小时,并且不能通过 Bridge 客户端控制。或者,您可以修改虚拟连接,在默认的 2 小时期限内进行刷新,或者切换到已发布的数据源。
默认情况下,客户端的超时限制设置为 24 小时。您可以通过 Bridge 配置文件更改客户端的超时限制。如果因为达到超时限制而取消了数据提取刷新,您将在客户端中看到一条消息,并且系统会向数据源所有者发送电子邮件通知。
必须重新启动客户端以使对配置文件所做的任何更改生效。
"dataSourceRefreshSettings" : {
"shutdownTimeoutInSeconds" : "00:00:30",
"downloadDataSourcesInterval" : "00:30:00",
"checkRefreshDataSourcesInterval" : "00:00:05",
"extractRefreshTimeout" : "24:00:00",
"maxRemoteJobConcurrency" : 10,
"JSONLogForExtractRefresh" : false,
"dataSources" : [
]
}
loggerSettings
配置:loggerSettings
选项:
maxLogFileSizeInMB | 日志文件的最大大小(以 MB 为单位)。当日志文件超出大小限制时,将会创建新日志文件。 默认值:25 MB。 可配置。 |
maxBackupLogFileCount | 允许的最大 Bridge 日志文件数。当日志文件数量超过限制时,最旧的日志文件将被删除。 默认值为 40。 可配置。 |
remoteRequestLogFileLifeSpan | 对于发送到客户端的每个 Bridge 刷新作业,都会创建一组新的日志文件:
默认情况下,如果日志文件数量超过
默认值:8 小时 可配置。 |
示例
客户端在其正常操作过程中会创建活动的日志。您可以使用这些日志来监视刷新、对 Bridge 问题进行故障排除,或者在 Tableau 支持部门向您请求日志以帮助解决问题时使用。
您可以管理 Bridge 日志文件的大小或增加日志文件在 TabBridgeClientConfiguration.txt 文件中删除之前的保留时间。
注意:名为 tabprotosrv* 的日志文件与其他 Bridge 日志文件不同。最大大小为 1 MB,允许的日志文件的最大数量为 8192。这些值也是不可配置的。
"loggerSettings" : {
"maxLogFileSizeInMB" : 25,
"maxBackupLogFileCount" : 40,
"remoteRequestLogFileLifeSpan" : "00:00:00"
}
dataSyncRestartInterval
配置:dataSyncRestartInterval
设置数据同步的重启间隔。 可配置。 |
internetConnectionMonitorInterval
配置:internetConnectionMonitorInterval
Bridge ping 互联网以确定是否存在有效连接的时间间隔。 默认值:30 秒 可配置。 |
secureStorageMonitorInterval
配置:secureStorageMonitorInterval
Bridge 确定安全存储的时间间隔。 不可配置。 |
cleanUpTempDirOnStartUp
配置:cleanUpTempDirOnStartUp
确定是否在 Bridge 客户端启动时移除临时文件。 默认值:true 可配置。 |
JSONLogForLiveQuery
配置:JSONLogForLiveQuery
设置为 true 时,客户端会生成一个 JSON 格式的附加日志文件。日志捕获实时查询请求的指标,每个数据提取 JSON 日志文件的格式是 Tableau Desktop 可读的,并可用作创建实时可视化项的数据源。有关详细信息,请参见 JSON 文件。 更改此配置选项的值需要重新启动 Bridge 客户端。 默认值:true 可配置。 |
示例
"dataSyncRestartInterval" : "24:00:00",
"internetConnectionMonitorInterval" : "00:00:30",
"secureStorageMonitorInterval" : "00:00:30",
"cleanUpTempDirOnStartUp" : true,,
"JSONLogForLiveQuery" : true
}
默认配置文件
若要复制默认配置文件,请单击右上角的“复制到剪贴板”图标。
{
"serviceConnectionSettings" : {
"serviceUrl" : "https://online.tableau.com/",
"connection" : {
"connectTimeout" : "00:01:00",
"operationTimeout" : "00:15:00",
"maxAttemptsToRedirectHttpRequests" : 20
},
"connectionPool" : {
"size" : 10
}
},
"dataSourceRefreshSettings" : {
"shutdownTimeoutInSeconds" : "00:00:30",
"downloadDataSourcesInterval" : "00:30:00",
"checkRefreshDataSourcesInterval" : "00:00:05",
"extractRefreshTimeout" : "24:00:00",
"maxRemoteJobConcurrency" : 10,
"JSONLogForExtractRefresh" : false,
"dataSources" : [
]
},
"loggerSettings" : {
"maxLogFileSizeInMB" : 25,
"maxBackupLogFileCount" : 40,
"remoteRequestLogFileLifeSpan" : "08:00:00"
},
"dataSyncRestartInterval" : "24:00:00",
"internetConnectionMonitorInterval" : "00:00:30",
"secureStorageMonitorInterval" : "00:00:30",
"cleanUpTempDirOnStartUp" : true,
"JSONLogForLiveQuery" : true
}